为什么要学 Markdown
作为一个业余编程爱好者,笔者学 markdown 有以下几点原因:
要用。比如本文就是用 markdown 写的,另外,github 上的说明文档也常常是用 markdown 写的,我喜欢用来练习 python 的 jupyter notebook 也会用到一点 markdown。
好看。markdown 写出来的文章很好看(正如本文)。
易上手。常用的语法不多,所以看完本文你就能上手 markdown。
Markdown 常用语法
注意:以下标记符号通常要紧接一个空格使用。
标题
以井号 #
开头的文本显示为标题,一个 #
对应一级标题,两个 #
对应二级标题。最多支持六个 #
,对应六级标题。示例代码如下:
###### 我是六级标题
显示结果如下:
我是六级标题
区块
使用大于号 >
开头的文本显示为区块。示例代码如下:
> 我是区块
显示结果如下:
我是区块
列表
以减号 -
开头的文本显示为无序列表,以 1.
2.
开头的文本显示为有序列表。示例代码如下:
- 我是无序列表第一项
- 我是无序列表第二项
1. 我是有序列表第一项
2. 我是有序列表第二项
显示结果如下:
- 我是无序列表第一项
- 我是无序列表第二项
- 我是有序列表第一项
- 我是有序列表第二项
段落
段落之间要加一个空行。如果在一个段落结束后只按一次回车,则下一段的格式跟上一段相同。
如下图所示,左侧编辑区第二行文字没有以 >
开头,但右侧预览区仍然显示为区块。在两行文字间加一个空行则正常显示。
字体
用 一对星号 *
包围起来的文本显示为斜体,用两对 *
包围起来的为粗体,用三对 *
包围起来的为 又粗又斜体。
与上述标记符号不同的是,星号与文本之间不能加空格。示例代码如下:
*我是斜体* **我是粗体** ***我是又粗又斜体***
显示结果如下:
我是斜体 我是粗体 我是又粗又斜体
代码块
用三对反引号 ` 括起来的文本显示为代码块,在前面的反引号后紧接编程语言名称可以按格式高亮代码。如果想显示代码片段,可以用一对反引号括起来。示例代码如下:
```python
print('hello world')
```
显示结果如下:
print('hello world')
文字链接
文字链接格式为 [链接描述文本](链接)
。示例代码如下:
[百度一下,你就知道](http://www.baidu.com)
显示结果如下:
插入图片
插入图片的书写格式为 [图片描述](图片链接)
。示例代码如下:

显示结果如下:
表格
用竖线 |
分隔单元格,用减号 -
分隔表头和内容。在表格代码第二行中,:-
表示左对齐,-:
表示右对齐示,:---:
表示居中。例代码如下:
| 左对齐 | 右对齐 | 居中 |
| :---- | -----: | :-----: |
| 我是单元格 | 我是单元格 | 我是单元格 |
显示结果如下:
左对齐 | 右对齐 | 居中 |
---|---|---|
我是单元格 | 我是单元格 | 我是单元格 |
Markdown 相关工具推荐
编辑器
- Atom。我用的就是这款,感觉不错。
- Mou。号称目前最好用的免费 Markdown 编辑器,仅支持苹果操作系统。
图床
图床指的是一个在互联网上存储图片的地方,我们用 markdown 插入图片时,要用到图片的链接,所以要先把图片上传到图床,拿到图片的链接。
我用到的图床是「公益图床」,不算很好,读者可以在 「盘点国内免费好用的图床」 找找更好用的。
参考资料
- 简书:「Markdown——入门指南」
- 菜鸟教程:「Markdown 教程」
- 官方文档:「Markdown Guide」
- CSDN:「几款主流好用的markdown编辑器介绍」
- 知乎:「盘点国内免费好用的图床」