[排版]MarkDown排版从入门到进阶

TOC

	- [目录1](#目录1)
		- [目录1.1](#目录1.1)

空白符和段落

1. 空白符

   • 包括Space、Tab、Enter
   • 一个Tab等于最多四个空格
   • 不论多少个连续的Space或Tab或Enter,一般渲染后只显示一个空格(不会有换行效果)
   • 如果要显示换行,需要在上一行结尾处打上两个Space和一个Enter或两个Enter
   • 如果两行文字之间存在一个或多个空行, 那么这些空行渲染后会显示一个空行

2. 字符

   • 支持ASCII字符和Unicode编码字符

3. 段落

   • md语言的段落由前后空行分割
   • 在段落中直接换行不会显示为换行,如果需要在此处输出一个换行,应该在上一行的结尾加两个空格再回车

分割线和标题

• 一行连用三个或以上的’*‘或’-‘或’_’

  • 使用’-'前要注意前有空行,不然会和标题混淆
  • 这些符号之间可以有空格
  • 分割线上下为两个段落

• md语言支持两种格式的标题写法

  • 类Setext式:用任意数量的’=‘或’-‘卸载标题的下一行,表示标题格式(’=‘表示最高阶标题,’-'表示第二阶标题)

    你好
    ====
    世界
    ----
    

  • 类atx式:在行首加1到6个#(后加Space,然后写标题内容),对应1到6级标题

    • 如果一行被视为标题,那么即使这一行前后没有空行也被视为一个独立的段落

      # 一级
      ## 二级
      ### 三级
      #### 四级
      ##### 五级
      ###### 六级
      

列表与缩进

1. 无序列表

• + 无序列表
• - 有序列表
• * 缩进显示
• 在这些符号后空一格然后输入内容

2. 列表嵌套

   • 如果希望一个没有加列表点的段落和一个列表项的内容对齐.需要把非列表段落首行打一个Tab

       * 我们需要.....
     
       	还没说完.....
       	以及.....  
     
       PS:.....
     

     显示为

     • 我们需要…

       还没说完…
       以及…

     PS:…

3. 有序列表：用数字加.在行首表示有序列表,在.后空一格在写内容

   有如下3点:
   1. 第一点
   2. 第二点
   3. 第三点
   

   显示为

   有如下3点:

   1. 第一点
   2. 第二点
   3. 第三点

4. 关于缩进的’容忍度’

   • 行首如果有大于三个Space,本行被视为代码段落。代码段落会原样输出所有符号。
   • 标题标记，列表标记符号之后除了必须的一个Space,如果还有大于三个Space,那么认为后接了一个代码段落

   •   这是代码段
     

强调和转义字符

• 斜体：成对的*或_

• 加粗：成对的**或__

• 斜粗体:成对的***或___

• 删除线: 成对的~~

  • 这一句不要了

• 特殊字符的原样输出

  • 在符号前加反斜杠\

  \\  
  \`  
  \#  
  \*  
  \<>
  

  显示为

  \
  `
  #
  *
  <>

引用块

1. 在每行行首加'>',注意加双Space,不然只会显示一行。

   >这是一则引用  
   >每行行尾没有双空格  
   >所以会显示为一行引用  
   

   显示为

   这是一则引用
   每行行尾加了双空格
   所以会显示为分行引用

2. 引用中可以使用其它样式。也可以嵌套引用

   >一级引用
   >>二级引用
   >
   >欢迎回到以及引用
   >>再次使用二级引用
   >
   >上边空行表示结束二级引用
   

   显示为

   一级引用

   二级引用

   欢迎回到一级引用

   再次使用二级引用

   上边空行表示结束二级引用

行内代码和代码段落

1. 行内代码:使用反引号把代码引起来,如果代码中巴汉反引号,可以使用双反引号来开始和结束代码插入
2. 代码区块

   • 缩进式代码区块，如果一行开头是大于等于四个Space或一个Tab,则本行被识别为代码区块

     	这是一个普通段落
     
     		这是一个代码区块
     

     显示为

     这是一个普通段落

       这是一个代码区块
     

   • 围栏式代码区块

     • 支持使用三个反引号或三个波浪线作为开始和结束标志

         ```
         代码块1
         ```
       
         ~~~
         代码块2
         ~~~
       

     显示为

     代码块1
     

     代码块2
     

链接和图片

• 行内式链接

    [Markdown](http://www.github.com/markdown "官方主页")
  

  显示为
  Markdown

  • 地址后空一格写title文字,可选,鼠标悬停可看

• 参考式链接

    [Markdown][id]  
  
    [id]:http://www.github.com/markdown "官方主页"
  

  显示为

  Markdown

  适合于放到文章末尾

• 图片插入的格式是在链接的基础上在方括号之前加!

• 自动链接：直接将网址链接到其所表示的网页

  显示为
  http://www.baidu.com

表格

• 表格语法使得| - : 具有更多语法意义,建议|与其它内容之间最少一个空格
• 表格由行列组成
  • 不同行之间用Enter分割(不需要双空格)
  • 同行之间不同列使用|,行首和行尾也可以使用|
  • 同一张表格,各行的列数应该相同,没有内容也要用空单元格凑
  • 一个表格的源代码第一行是i鳌头。但是填写规则和普通单元格一样
  • 一个表格源代码的第二行不会渲染成一行单元格。它被用来分隔表头和普通单元格。这一行每一单元格都填写大于等于三个—
  • 第二行的单元格还可以控制本列的对齐方式,在—左侧加:实现左对齐,右侧加右对齐,双侧加居中。
• 实例

   | Left-aligned | Center-aligned | Right-aligned |
   | :--- 		| :---: 		 | ---: 		 | 
   | git status	| git status	 | git status	 |
   | git diff		| git diff		 | git diff		 |
  

  显示为

  Left-aligned	Center-aligned	Right-aligned
  git status	git status	git status
  git diff	git diff	git diff

LaTeX数学式

• $ 表示行内公式
• $$ 表示整行公式

$$\sum_{i=1}^n a_i=0 $$

$$\sum _{i=1}^n{a}_i=0$$

$$f(x_1,x_x,\ldots,x_n)=x_1^2 + x_2^2 + \cdots + x_n^2 $$

$$f(x_1,x_x,\dots ,x_n)=x_1^2+x_2^2+\cdots +x_n^2$$

$$
\begin{bmatrix}
1 & 2 & 3 \\
4 & 5 & 6 \\
7 & 8 & 9
\end{bmatrix}
$$

$$\left[\begin{array}{ccc}1& 2& 3\\ 4& 5& 6\\ 7& 8& 9\end{array}\right]$$

$$ \cos (2\theta)=\cos^{\lim _{x \to \infty} \exp (x)}\theta-\sin^2\theta + \sum ^n_{i=1}\phi^{2^{z_-1}}_i $$

$$\cos (2\theta )={\cos }^{{\lim }_{x\to \infty }\exp (x)}\theta -{\sin }^2\theta +\sum _{i=1}^n{\varphi }_i^{2^{z_{-}1}}$$

脚注

使用 [^keyword] 表示注脚。

这是一个注脚[^1]的样例。  
这是第二个注脚[^2]的样例。
[^1]:123  

[^2]:123

显示为
这是一个注脚¹的样例。

这是第二个注脚²的样例。

标签和分类

一般在文首输入tags添加标签，categories添加分类：

tags: 
   - Markdown
   - 语言
categories:
   - 技术

流程图

```mermaid
flowchat
flowchat
st=>start: 开始
io=>inputoutput: 验证
op=>operation: 选项
cond=>condition: 是 或 否？
sub=>subroutine: 子程序
e=>end: 结束
st->io->op->cond
cond(yes)->e
cond(no)->sub->io
```

显示为：

Created with Raphaël 2.2.0 开始 验证 选项 是 或 否？ 结束 子程序 yes no

---

1. 123 ↩︎

2. 123 ↩︎