段落、换行
一个Markdown段落是由一个或多个连续的文本行组成,它的前后要有
一个以上的空行
(空行的定义是显示上看起来像是空的,便会被视为空行
标题
1 | # 这是H1 |
区块引用 Blockquotes
用
>
的引用方式,符号标记后至少接一个空格或制表符:
1 | > this is a blockquote with two paragraphs. Lorem ipsum dolor sit amet, |
也可以在整段文字的第一行前面加>
:1
2
3> this is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus
列表
无序列表
无序列表使用
星号(*)
、加号(+)
或是减号(-)
作为列表标记:
1 | * Red |
- Red
- Green
- Blue
有序列表
有序列表使用数字接着一个英文句点,数字可以是不按序号来,但是养成好习惯,还是从1开始计算:
1 | 1. Red |
- Red
- Green
- Blue
分隔线
你可以在一行中用三个以上的星号、减号、底线
来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:1
2
3
4
5* * *
***
*****
- - -
---------------------------------------
链接
1 | [title](url) |
添加图片的方法:
行内式的图片语法:1
图片为:![图片说明](图片路径)
参考式的图片语法:1
![图片说明][id]
「id」是图片参考的名称,图片参考的定义方式则和链接参考一样:1
[id]: url/to/image "Optional title attribute"
强调
Markdown 使用星号()和底线(_)作为标记强调字词的符号,被 或 包围的字词会被转成用 标签包围,用两个 * 或 包起来的话,则会被转成 < strong >
1 | *single asterisks* |
表现如下:
single asterisks
single underscores
double asterisks
double underscores
如果要在文字前后直接插入普通的星号或底线,你可以用反斜线:1
\*this text is surrounded by literal asterisks\*
代码
行内代码可以用一对反引号(`)包起来:
1 | Use the `printf()` function. |
如果是插入代码块,则用多个反引号包起来,一般习惯用3个反引号
1 | /```There is a literal backtick (`) here.```/ |
最后,Markdown 支持以下这些符号前面加上反斜杠(/)来帮助插入普通的符号:
1 | \ 反斜线 |