本文转自 https://nepton.github.io/blog/markdown/markdown-grammar
作者：nepton
本文采用 Creative Commons BY-NC-ND 许可协议，版权归作者所有。 欢迎转载，但必须保留此段声明且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。 感谢您的支持，这是对我最大的鼓励。
想5分钟学会使用 Markdown 的标记语法？集中你的注意力，往下看。如果你是一名技术工作者，你会发现 Markdown 的语法简直是世界上最简单的语法了。如果你是一名作家，担心所谓的“标记”语言？别担心，我保证你5分钟，就学会了。
语法主要分为字体控制：
粗体：使用 **
斜体：使用 _
标题：使用 #
引用：使用 >
横线: 使用 —
列表：使用 * 或者 1. 2. 3.
链接：使用
图片：使用
段落：敲回车，或者敲空格
对于技术人员，你还需要引用代码块，
代码块： 使用 `
多行代码块： 使用 ```
没有了，到此结束
当然还有很多社区志愿者扩展了这些符号，例如绘制表格、删除线、页内跳转、注释等等，这些使用频率较低，我将在以后博文中讲解。
粗体和斜体
我们首先学习文本格式中的两个基本元素：粗体和斜体。
红色内容
您会注意到一些格式化的 红色内容，这些内容是含有Markdown排版格式的内容，为了提醒您的注意，因此把这些文本标记为红色突出显示，请注意这些内容中非同寻常的符号与排版，Markdown 就是通过他们让您的文章井井有条。
您在排版时候，需要创建一个斜体，怎么做呢？在 Markdown 中这很简单，您只需要需要斜体化的文字两侧添加下划线（_）或者星号（）。 例如，你好 或者 你好* 将变为斜体。简单吧，变为斜体就是这样简单。
如果要把文字变为粗体，只需要在这些文字两侧添加双星号（）, 例如我非常喜欢**去吃海鲜！
当然，你可以同时把文字变为 粗体 和 斜体，只需要把这些符号都加上！ 比如：我周末要陪 孩子 去公园玩！通常，先写星号或下划线的顺序无关紧要。
标题
我们来看看这个重量级的家伙——标题。文章需要分章节，在这时，标题就可以大显身手。他为每一章节的内容取一个名字，醒目的显示出以下内容是什么。
标题有六种类型，从大到小分别为：
标题示例
要在Markdown中创建标题，请在标题内容前添加一个井号（#），一级标题放一个井号（#），二级标题放两个井号（##）,三级标题放三个井号（###），以此类推。
同时，标题的内容中可以增加星号或者下划线更改标题内容的样式。
引用
如果您要引用一段内容，或者如果您需要读者特别关注一句话，那么使用Markdown的引用语法将非常有用。使用了引用的内容，将会出现特别格式化的句子或段落，以引起读者的注意。例如：
买好的，更要买的好。
要创建这样一段引用块，您只需要在这行话前，添加一个大于号（>）就行，例如上一句内容 Markdown 语法如下：
买好的，更要买的好。
横线
有时候您需要在文章中添加一条漂亮的横线作为分隔，如果要绘制一条横线，只需要在单独一行内，输入三个相同的星号（***）、三个相同的减号（---）或者三个相同的下划线（___）就行。
不过有一点需要注意，这一行不要再添加其他内容。
列表
列表分为两种，一种是以一个“点”开头的无顺序列表，另一种是以数字开头的有序列表。
无顺序列表在列表项的每一行开头，添加一个星号（*），加号（+）或者减号（-），例如：
理解风险
识别风险
控制风险
我们是这样实现上边这个列表的：
- 理解风险
- 识别风险
- 控制风险
如果要实现一个有序的列表，在每一行的开头添加一个数字，外加一个点（1.）即可，上边这个无序列表经过改造后，变成以下有序列表：
理解风险
识别风险
控制风险
实现的方法如下：
- 理解风险
- 识别风险
- 控制风险
如果要实现嵌套的列表，嵌套的可以通过列表缩进一些空格实现，这里您要问了，你说的 “一些空格” 是多少呢？”一些” 的数量要看情况，对于”1. “、”2. “、”3. “ 的情况是3个空格，对于 “* “、”+ “ 的情况是2个空格，这里的原则是：使用空格缩进后保证新行的起始于上一行的正文区域，
indent_example
上面的例子中，”* 风险是什么”的星号对齐上一行的正文第一个字”理”，markdown则认为这是一个新的缩进，以此类推，您以后就能够自由灵活的控制缩进了。
链接
如果您要创建一个鼠标可以点击的文字，用户点击后跳转到另一个网址，您就要用到链接。在Markdown中，链接非常简单，最简单的链接，就是直接把网址完整的粘贴到页面中即可，例如：https://nepton.github.io，您点点看，点击以后，您的浏览器的页面是不是就跳转到我的首页了。
您要说，很多人制作的链接不是这样乱七八糟的英文字母，而是通俗易懂的网站名，没关系，哈哈，这么做，把您刚才输入的网址用一对小括号括起来，在左括号的前边，给这个网址取一个名字，再用中括号把这个名字也括起来，就大功告成，做完后是这样子的：[豆豆的故事](https://nepton.github.io)，您来点一下 豆豆的故事 试试看，是不是一样的效果呀。
图片
显示图片的原理跟显示链接差不多，因为图片本身也是一个链接嘛，所以格式几乎一模一样，区别仅仅在于，在链接格式的最左边，再加一个感叹号（!）。
完整的格式是：。
我们马上做一个，我们给图片取个名字叫”我的图片”，地址为：https://picsum.photos/500/300， 这是一个专门提供图片的网站，我们仅拿这个链接做测试。好了，完整的格式如下：
看看效果是什么样的，怎么样，是不是 Markdown 很简单。
我的图片
段落
段落就是敲回车，让两段话之间空出一个空行。Markdown 会自动的把内容分割为两端话，如果您敲了回车后，新段落前没有单独空一行，就不算新分段。您看下边的例子：
从前，有个国王和王后，他们很富有，简直享有一切他们所希望的东西，只是没有孩子。 王后为此日夜伤感，说：“我就像块不长庄稼的地。”。
以上2行原文之间有一个回车分隔，但是新段落前没有单独空行，因此 Markdown 认为自一段话，显示效果如下：
从前，有个国王和王后，他们很富有，简直享有一切他们所希望的东西，只是没有孩子。 王后为此日夜伤感，说：“我就像块不长庄稼的地。”。
如果在两行之间，插入一个空白行，就成为了两段话，您看，原文第二行现在是空白的一行，此时 Markdown则认为这是两段话。
从前，有个国王和王后，他们很富有，简直享有一切他们所希望的东西，只是没有孩子。 王后为此日夜伤感，说：“我就像块不长庄稼的地。”。
以上内容Markdown显示的结果为：
从前，有个国王和王后，他们很富有，简直享有一切他们所希望的东西，只是没有孩子。
王后为此日夜伤感，说：“我就像块不长庄稼的地。”。
有些时候，您要写一首小诗，都是一行一句的，但是又不想通过分段分隔，因为那样插入空行后，行与行之间的间距很大，会很难看，这时候要怎么办呢？
如果是这样的情况，请保留小诗一行一句的格式，然后，在每一行的末尾增加两个空格，试试看，是不是得到了漂亮的排版？
灵台无计逃神矢，
风雨如磐暗故园。
寄意寒星荃不察，
我以我血荐轩辕。
—— 鲁迅
恭喜您
恭喜您，您此时可以正式开始使用 Markdown 书写您的文章或者博文了，基本的用法就这些，您花费了5分钟时间阅读本文学习到了Markdown的使用，会让您以后在写作时受益匪浅。如果您需要继续了解学习Markdown的更多用法。我会在以后的博文中深入讲解。
在这里给您推荐一些有用的Markdown网站，
https://www.markdowntutorial.com 由 gjtorikian 提供的在线教程非常棒。
http://en.wikipedia.org/wiki/Markdown Wiki 提供的Markdown介绍。
https://www.markdownguide.org 提供了Markdown的基本语法和扩展语法介绍。