MarkDown常用语法

MarkDown常用语法

总结MarkDown常用语法，及使用中的注意事项，并且熟悉和练习。只是最常用的，对于公式、流程图、表格等比较复杂的暂时没有研究。
MarkDown编辑器的作用就是将以MarkDown语法写的文字转变为html格式。

注意： MarkDown并没有统一的标准，各编辑器对语法的使用略有不同，另外有多种扩展语法。

标题

标题有两种方法：

• Atx风格：段前加‘#’号，从1个到6个，分别为一级（最大）到六级（最小）。
• Setext风格：文字下加‘===’或‘—’，前一个比后一个字号大。几个符号没有要求。

引用

文字前加‘>’号，多级引用可以加多个。回车后自动在下一行加引用符号。引用后要空一行或有其他标记才能结束。

一级引用
还是一级引用

二级引用

恢复上一级引用

斜体和粗体

• 斜体：需要斜体的文字前后加一个星号。
• 粗体：需要重点标注的文字前后加两个星号。

删除线和分割线

• 删除线：，文字中间的删除线。
  在文字前后加两个波浪线，，会在文字中间加上删除线。
• 分割线：横贯显示区的分割线
  连续三个或以上星号或下划线，产生横贯显示区的浅色分割线。

---

---

无序列表

‘*’号’+’号’-‘号后空一格，回车后在下一行自动产生列表标记，如果退格删除列表标记，下一行也会缩进，要取消需要有新的标记或空一行。

• 星号无序列表
• 加号无序列表
• 减号无序列表
  回车后下一行即使没有列表标记也会和上一行一样的缩进。
  继续回车下一行还是在缩进。
  直到有新的标记或空一行

有序列表

数字后加’.’，可以不空一格，但空一格的效果好，有缩进。

1. 有序列表
   
   1. 有序列表也可以分层，方法是在数字前加空格
2. 回车自动添加标记
   即使删除数字也有相同的缩进，但没有数字了
   直到有新的标记或空一行

复选框

‘-‘后跟一个中括号’[ ]’，这个只有马克飞象支持，能够在生成的文字中选中或取消选中。其他编辑器只能模拟一下。

• [ ] 复选框，未选中
• [x] 复选框，选中

链接

链接有两种方式：

• Inline：内联方式，由一个方括号和一个圆括号组成，方括号内是要显示的文字，圆括号内是链接的url，不显示。如：新浪新闻首页；或者用尖括号框起url，显示链接。如：http://www.csdn.net
• Reference：引用方式，也是由一个方括号和一个圆括号（或方括号）组成，方括号内是要显示的文字，圆括号内是一个引用ID，在其他位置以[ID]:url的形式给出链接，ID和引用都不显示。例如：新浪新闻首页。

图片

图片和链接类似，也分为两种方式：

• Inline：内联方式，类似链接的内联方式，只是在最前面加一个’!’号。如：
  
• Reference：引用方式，类似链接的引用方式，只是在方括号前加’!’号。如：
  
  不论哪种方式，都需要先上传图片。

代码

代码有三种方式：

• 行内代码：在一行内的代码，前后加反引号，printf("Hello,World!");，注意反引号要用英文。

• 代码区块：以Tab键开始的段落或空四格。

  printf("Hello,Markdown!");
  

• 代码区块和语法高亮：在需要高亮的代码块的前一行及后一行使用三个反引号“`”，同时第一行反引号后面表面代码块所使用的语言，可以高亮语法。

#include <stdio.h>
int main(void)
{
    int xyz;
    scanf("%d", &xyz);
    printf("%d\n", xyz);
    return 0;
}

其他的还有：

• 流程图
• LaTex数学公式
• 表格

几点注意：

• 转义符：如果文字中需要有MarkDown标记相同的内容，在其前面加上反斜杠转义符，就不会作为MarkDown标记解释。如：##不会解释为标题。
• 很多情况下，除非有新的标记，回车并不会改变前一行的标记，可能需要加一个空行。
• 正文中的多个空行只显示空一行。同样，正文中的多个空格只显示一个空格，如果需要显示多个空格，可以输入全角空格。