Markdown是一种轻量级标记语言,创始人为约翰·格鲁伯。它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,目前许多网站都广泛使用Markdown来撰写帮助文档或是用于论坛上发表消息。如GitHub、Reddit、Diaspora、Stack Exchange、OpenStreetMap 、SourceForge、简书等,甚至还能被用来撰写电子书。
详细参考:百度百科
使用 Markdown 一定要意识到,我们并不是在 “编辑样式”,而是在 “标记结构”。
也就是说,我们并非在尝试加粗、标红某些文字表现出来的样子,而是在告诉软件,“这段文本是一个标题”,“这段文字是一个段落”,“这段文字是一段引用”。
在写文章中,我们通常需要设计文章的结构,比如有一级标题,作为文章的主要脉络(相当于思维导图的主干分支);有二级标题作为对一级标题的详细说明,三级标题再来细化二级标题,依次类推。
通常,我们不建议标题的层级超过三级,也就是说,我们通常只会用到前面三个层级的标题。
那么如何标记标题的结构呢?很简单:
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题(只有六级,没有第七级标题)
需要注意的是,“#” 号的后面需要加空格哦,不然不会有任何效果。
在 Markdown 里面,段落跟换行并非同一个概念。段落是指一个新的文本块;而换行只是在同一个段落中,刻意的换一行,上下两行还是在同一个段落中。
段落很简单,两行文本之间留空一行即可:
第一段落
第二段落
注意,上面的两个段落中间,有一行是留空的。
而换行则是在上一行的末尾,多加两个空格
:
第一行 ←这里有两个空格
第二行
如果不留两个空格,Markdown 在转化后,还是会合并成同一行。
当我们在罗列一些内容的时候,就需要用到列表功能了。
列表有两种:
1. 第一项
2. 第二项
3. 第三项
注意,我们 “1.” 后面必须加一个空格,才会被识别。
在实际操作中,有时会碰到,向列表中间插入一个项目,但你会发现,后面的所有序号都要手动再改一遍,这非常麻烦。Markdown 也考虑到这种需求,于是语法支持一种 “自动的序号”:
1. 第一项
1. 第二项
1. 第三项
所有的条目前面,统统都用 “1.” 这样,不论插入几次,都写 “1.” 而 MarkDown 则会自动帮助我们计算出序号。
无序列表的语法非常简单:
* 第一项
* 第二项
* 第三项
直接星号“*” + 空格,就行了。
不论是有序还是无序列表,都会有层级的需要,语法也很简单:
* 一级(前面没有空格)
* 二级(前面有两个空格)
* 三级(前面有四个空格)
* 一级
前面每加两个空格,就是缩进一个级别:
有时我们需要引用别人的原话,就需要标记这段是引用的。
> 这是一段引用的话
注意,这里是英文的大于号(也叫左尖括号),并且后面要接一个空格
脚注使您可以添加注释和参考,而不会使文档正文混乱。当您创建脚注时,带有脚注的上标数字会出现在您添加脚注参考的位置。读者可以单击链接以跳至页面底部的脚注内容。
要创建脚注参考,请在方括号([^1])内添加插入符号和标识符。标识符可以是数字或单词,但不能包含空格或制表符。标识符仅将脚注参考与脚注本身相关联-在输出中,脚注按顺序编号。
在括号内使用另一个插入符号和数字添加脚注,并用冒号和文本([^1]: My footnote.)。您不必在文档末尾添加脚注。您可以将它们放在除列表,块引号和表之类的其他元素之外的任何位置。
这是一个简单的脚注[^1],这是一个很长的脚注.[^bignote]
[^1]: 这是第一个脚注内容。
[^bignote]: 这是一个多段落的脚注,
带缩进的段落将会包括在脚注中。
`{ my code }`
你想加多少段落都可以。
呈现的输出如下所示:
任务列表使您可以创建带有复选框的项目列表。在支持任务列表的Markdown应用程序中,复选框将显示在内容旁边。要创建任务列表,请在任务列表项之前添加破折号(-)和方括号,并[ ]在其前面加上空格。要选择一个复选框,请x在方括号([x])之间添加in 。
- [x] 一个番茄钟完成思维导图
- [ ] 更新我的博客
- [ ] 跟神之业老师交流一次
呈现的输出如下所示:
语法很简单:

举例

效果
有时我们需要将一个链接放到一个文本上:
[漫步官网](https://www.mbrs.group)
[漫字典](https://wiki.mbrs.group)
也可以是在一个段落中进行标记:
这是一个关于[漫步人生官网](https://www.mbrs.group)的使用说明文档。
效果:
这是一个关于漫步人生官网的使用说明文档。
我们有时需要更加规范的表格来呈现数据——当然,这里只是呈现,并没有excel那种计算功能的作用——我们就能用以下的语法:
|表头|表头|表头|
|---|:--:|--:|
|左对齐|居中|右对齐|
|对齐|中|对齐|
|齐|中|齐|
第二行特别说明:
效果:
表头 | 表头 | 表头 |
---|---|---|
左对齐 | 居中 | 右对齐 |
对齐 | 中 | 对齐 |
齐 | 中 | 齐 |
要加粗的文字左右分别用两个 * 号包起来
**这是加粗的文字**
效果:这是加粗的文字
要倾斜的文字左右分别用一个 * 号包起来
*这是倾斜的文字*
效果:这是倾斜的文字
要倾斜和加粗的文字左右分别用三个 * 号包起来
***这是倾斜并加粗的文字***
效果:这是倾斜并加粗的文字
要加删除线的文字左右分别用两个 ~~ 号包起来
~~这是加删除线的文字~~
效果:这是加删除线的文字
三个或者三个以上的 - 或者 * 都可以。
---
***
效果如下:
Markdown 还支持:
有两种方法可以将表情符号添加到 Markdown 文件中:将表情符号复制并粘贴到 Markdown 格式的文本中,或者键入 emoji shortcodes
。
在大多数情况下,您可以简单地从 Emojipedia 等来源复制表情符号并将其粘贴到文档中。许多Markdown应用程序会自动以Markdown格式的文本显示表情符号。从Markdown应用程序导出的HTML和PDF文件应显示表情符号。
一些Markdown应用程序允许您通过键入表情符号短代码来插入表情符号。这些以冒号开头和结尾,并包含表情符号的名称。
去露营了! :tent: 很快回来。
真好笑! :joy:
呈现的输出如下所示:
去露营了! 很快回来。
真好笑!
Note: 注意:您可以使用此表情符号简码列表,但请记住,表情符号简码因应用程序而异。有关更多信息,请参阅Markdown应用程序的文档。
许多Markdown处理器会自动将URL转换为链接。这意味着如果您输入http://www.example.com,即使您未使用方括号,您的Markdown处理器也会自动将其转换为链接。
http://www.example.com
呈现的输出如下所示:
http://www.example.com
如果您不希望自动链接URL,则可以通过将URL表示为带 反引号
的代码来删除该链接。
`http://www.example.com`
呈现的输出如下所示:
http://www.example.com