Markdown 基本语法

马黑黑

Markdown 基本语法

【主意】Markdown 语法用到的符号均为小角符号！

一、标题

【语法】# 标题文本

标题共有 6 种类型，称为一级标题、二级标题、……六级标题，多少级就用多少个 # 号，最后一个 # 号和标题文本之间必须有一个空格。例：

# 一级标题 等同于 <h1>一级标题</h2>

## 二级标题 等同于 <h2>二级标题</h2>

二、段落

【语法】空白行

在需要创建段落的地方留一个空白行，没有任何内容。对标 <p> 标签。

三、换行

【语法】句末加两个或两个以上空格

如果自然文本行的末尾有两个或两个以上的空格，则视为换行。等效于 html 的 <br>标签 标签。

四、强调

（一）粗体

【语法】**粗体文本**

需要加粗的文本两边都用双 * 号包裹，文本和 * 号之间不能有空格。对应于 <strong> 标签。

（二）斜体

【语法】*斜体文本*

需要渲染为斜体的文本两边用单个 * 号包裹，文本和 * 号之间不能有空格。对应于 <em> 标签。

（三）粗斜体

【语法】***粗斜体文本***

需要渲染为粗体+斜体的文本两边用三个 * 号包裹，文本和 * 号之间不能有空格。对应于 strong 和 <em> 标签的嵌套结构。

五、块引用

【语法】>引用的文本

块引用对应于 html 种的 blockquote 标签，支持多级块引用嵌套，多少级就使用多少个符号 > 。在 html 中，默认情况下，块引用渲染的效果是文本缩退，但也可以通过 CSS 设置为其他样式。

六、列表

（一）有序列表

【语法】x. 项目名称

x 为阿拉伯数字，紧跟着一个 . 号，. 号后面必须要有一个空格都然后才是项目名称。

（二）无序列表

【语法】- 项目名称 或 * 项目名称 或 + 项目名称

符号 - * + 任选其一，符号和项目名称之间必须有一个空格。

【注】列表可以嵌套。父层和子层之间，父层不退格，子层用 Tab 键退格。一些所见即所得的编辑器在结束子层时需要打两次回车键。语法举例如下：

1. 父层项目一
2. 父层项目二
	1. 子层项目
	2. 子层项目二
3. 父层项目三

七、代码

【语法】`代码文本

所谓代码，对应于 html 标签 <code>，属行内标签，代码文本的前后用反引号 ` 包裹。若需要在代码中显示反引号，请用反引号转义反引号，也就是一对反引号连续写在一起，``。

八、分隔线

【语法】--- 或 ___ 或 ***

符号 -_* 任选其一，对表 html <hr> 标签，建议文档中使用前后一致的符号表示分割线。不论使用哪一种符号，至少要三个连续的相同符号才能渲染分隔线。

九、链接

【语法】[链接名称](链接地址 "弹出文本")

即锚，对应于 html 标签 <a>。链接名称写在中括号内，链接地址和弹出文本写在小括号内，其中弹出文本可选，若有，需要使用双引号包裹起来，且和链接地址间隔一个空格。

十、图片

【语法】![图片alt](图片地址 "弹出文本")

语法结构与锚高度相似，唯一不同的是前面有一个小角感叹号。

十一、转义字符

【语法】\待转义符号

因为 Markdown 语法中使用一些符号作为内置语法关键字，要显示这些符号就需要转义。除反引号 ` 使用自身转义自身外，其余符号均使用 \ 进行转义，符号 \ 和待转义符号之间不要留有空格。

十二、表格

【语法】

|姓  名|性  别|年  龄|
|:---:|:---:|---:|
|李大二|男|21|
|张小三|女|19|

具体操作：先制作表头，用管道符号 | 表示列；然后制作各列的对齐方式，--- 或 :--- 表示左对齐，:---: 为居中，---: 为右对齐；最后制作各行表格内容。

十三、内嵌HTML代码

Markdown 的语法非常有限，所以允许嵌入 html 代码以实现更为精细的渲染效果，例如给文本添加前景色，例如：

<span style="color: red;">红色文本</span>

<p style="text-align: center;">居中文本</p>

马黑黑

本文使用 Typora 编辑器按照 Markdown 语法进行编写，然后复制为 html 代码再加上一个壳后发布到这里。内容凭个人理解进行组织，如果有误，敬请各位指正。

马黑黑

使用 Markdown 写一篇文档无法就是这样的代码结构：

1. # 文章标题
   
2. 
   
3. 段落一
   
4. 
   
5. 段落二
   
6. 
   
7. ## 二级标题1
   
8. 
   
9. 段落三
   
10. 
    
11. 段落四
    
12. 
    
13. ## 二级标题2
    
14. 
    
15. 段落五
    
16. 
    
17. 段落N

复制代码

其他修饰，如文本加粗、斜体，分隔线，等等，在适当的地方加入加入适当的修饰语法即可。文章的标题层级则可以根据需要进行设计，段落还是换行可以根据需要而定。感觉吧，使用 Markdown编写文档还是很方便的。

红影

这个基本语法说明非常有用，学习了