Markdown语法及示例

1.标题语法:

Markdown 支持两种标题的语法,Setext形式和Atx形式
Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题)

例如:
A First Level Header
====================
A Second Level Header
---------------------

A First Level Header

A Second Level Header

Atx 形式在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶。

例如:
#一级标题
##二级标题
###三级标题
####四级标题
#####五级标题
######六级标题

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

</br>
2.引用
========
区块引用则使用 email 形式的 '>' 角括号。

例如:
> 引用
> 
>>引用中的引用
>
> ## 引用中的标题

引用

引用中的引用

引用中的标题

3.修辞和强调

Markdown 使用星号和底线来标记需要强调的区段。单标记表示斜体,双标记表示粗体

例如:
使用单星号: *星号斜体*
使用单下划线: _下划线斜体_
使用双星号: **星号粗体**
使用双下划线: __下划线粗体__

使用单星号: 星号斜体
使用单下划线: 下划线斜体

使用双星号: 星号粗体
使用双下划线: 下划线粗体
删除线:使用双波浪包含表示文字被添加删除线

~~删除线~~

删除线
4.列表
===
无序列表:使用星号、加号和减号来做为列表的项目标记

星号:
* Candy.
* Gum.
* Booze.
  • Candy.
  • Gum.
  • Booze.
加号:
+ Candy.
+ Gum.
+ Booze.
  • Candy.
  • Gum.
  • Booze.
减号:
- Candy.
- Gum.
- Booze.
  • Candy.
  • Gum.
  • Booze.

有序列表:使用一般的数字接着一个英文句点作为项目标记,数字不能省略但可无序,点号之后的空格不能少

1. Red
4. Green
3. Blue
  1. Red
  2. Green
  3. Blue

嵌套列表:
-+*可循环使用,但符号之后的空格不能少,符号之前的空格也不能少

- 嵌套列表1
 + 嵌套列表1a
 + 嵌套列表1b
  - 嵌套列表1ai
   * 嵌套列表1aix
- 嵌套列表2
  • 嵌套列表1
  • 嵌套列表1a
  • 嵌套列表1b
    • 嵌套列表1ai
      • 嵌套列表1aix
  • 嵌套列表2

5.分割线

三个或更多-_*,必须单独一行,可含空格(注意如果在文字后使用---,则为副标题)

---
___
***

效果:


6.链接与图片

在 Markdown 中,插入链接不需要其他按钮,你只需要使用[显示文本](链接地址) 这样的语法即可,例如:

文字超链:[简书](http://www.jianshu.com)
索引超链:
[百度][1]
[1]:http://www.baidu.com

自动链接:http://www.google.com   
邮箱链接:<northpolecan@xx.com>

简书
[百度][1]
[1]:http://www.baidu.com
http://www.google.com
northpolecan@xx.com

图片超链:在 Markdown 中,插入图片不需要其他按钮,你只需要使用 [图片上传失败...(image-45d29e-1570942014833)] 这样的语法即可,例如:

![](http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

*注:插入图片的语法和链接的语法很像,只是前面多了一个 !。*

7. 添加代码

Markdown语法:

`字符`(简短文字添加代码框)
`Tab`或四个空格(大段文字添加代码框,每行前添加)

字符
Tab或四个空格
大段代码框:在你的代码块的前面和后面都加上三个反引号 ` 即可,在第一行后指定编程语言,也可以不指定

@requires_authorization
def somefunc(param1='', param2=0):
    '''A docstring'''
    if param1 > param2: # interesting
        print 'Greater'
    return (param2 - param1 + 1) or None
class SomeClass:
    pass
>>> message = '''interpreter
... prompt'''

8.转义字符

特殊符号前可以加反斜线表示转义

\\ 反斜杠

\` 反引号

\* 星号

\_ 下划线

\{\} 大括号

\[\] 中括号

\(\) 小括号

\# 井号

\+ 加号

\- 减号

\. 英文句号

\! 感叹号

\ 反斜杠
` 反引号
* 星号
_ 下划线
{} 大括号
[] 中括号
() 小括号
# 井号
+ 加号
- 减号
. 英文句号
! 感叹号
9.表格
=====
1.使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行:

name | age   区分单元格
---- | ---         分隔表头和其他行
LearnShare | 12
Mike | 32
name age
LearnShare 12
Mike 32
2.为了美观,可以使用空格对齐不同行的单元格,并在左右两侧都使用 来标记单元格边界:
| name | age |
| ---------- | --- |
| LearnShare | 12 |
| Mike | 32 |
name age
LearnShare 12
Mike 32

在表头下方的分隔线标记中加入 :,即可标记下方单元格内容的对齐方式:

| left | center | right |
| :--- | :----: | ----: |
| aaaa | bbbbbb | ccccc |
| a | b | c |
left center right
aaaa bbbbbb ccccc
a b c

10.其他

段落缩进

半方大的空白 或 看,飞碟
全方大的空白 或 看,飞碟
不断行的空白格 或 看,飞碟
  段落从此开始。

HTML标签

<small>小字</small>
<br>强制换行
<big>大字</big>

<small>小字</small>


<big>大字</big>

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 221,430评论 6 515
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 94,406评论 3 398
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 167,834评论 0 360
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 59,543评论 1 296
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 68,547评论 6 397
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 52,196评论 1 308
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,776评论 3 421
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,671评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 46,221评论 1 320
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 38,303评论 3 340
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 40,444评论 1 352
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 36,134评论 5 350
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,810评论 3 333
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 32,285评论 0 24
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,399评论 1 272
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,837评论 3 376
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 45,455评论 2 359

推荐阅读更多精彩内容