Markdown常用语法笔记

Markdown常用语法笔记¹

1.标题及段落格式

• 表示格式：使用 # 来表示标题，分为1-6级，#越多，字号越小
• #与标题之间要隔至少一个空格符号
• 也可以使用 = 和 - 来表示标题，但需将他们单独放在标题的下一行，其中 = 代表一级标题，- 代表二级标题
• Markdown中无特殊的段落格式，使用两个及以上空格加回车进行换行；或在两个段落之间使用一整个空行代表换行

2.列表

• 无序列表
  • 使用 - * + 代表无序列表
  • 符号需与文本留一个空格符号
• 有序列表
  1. 使用数字代表有序列表
  2. 数字后要有一个 . 符号
  3. 1. 2. 3. 要和文本间隔一个空格符号
• 待办列表
  • 未完成项目：- [ ]
  • 已完成项目：- [x]
• 列表的嵌套只需在子列表中添加四个空格或使用Table键即可

3.链接

• 网址链接

  • 使用 [显示文本] (链接地址) 或<链接地址>来加入链接
  • [] 中写对链接地址的描述，可空
  • () 中写网址链接
  • 例子1：[百度搜索](www.baidu.com)百度搜索
  • 例子2：<www.baidu.com><www.baidu.com>

• 图片链接

  • 使用 ![] (图片链接地址 “可选标题”) 来创建图片链接
  • 相比于网址链接，图片链接在最前面多了一个 ! 号
  • Markdown 还没有办法指定图片的高度与宽度，如果你需要的话，你可以使用普通的 <img> 标签
  • 例子：![图片链接](https://imgconvert.csdnimg.cn/aHR0cHM6Ly90aW1nc2EuYmFpZHUuY29tL3RpbWc_aW1hZ2UmcXVhbGl0eT04MCZzaXplPWI5OTk5XzEwMDAwJnNlYz0xNTg1NDYyOTEzNjIwJmRpPWZmN2EzMWJhZTIyMDI3YjI2YzdmMmQxM2I5ZGU5YmEzJmltZ3R5cGU9MCZzcmM9aHR0cCUzQSUyRiUyRmItc3NsLmR1aXRhbmcuY29tJTJGdXBsb2FkcyUyRml0ZW0lMkYyMDE3MDQlMkYyNiUyRjIwMTcwNDI2MTk0NjM1X0JheE5mLmpwZWc?x-oss-process=image/format,png)
    

• 高级链接：通过变量设计链接，变量赋值在文档末尾进行

  •   [Baidu][1]
      
      [1]:http://www.baidu.com
    

  • Baidu

4.区块引用和注释

• 文字引用：

  • 在引用的文字前面加上>号可表示引用，并且多个>可以进行嵌套，例子：

  • 破阵子·为陈同甫赋壮词以寄之

    醉里挑灯看剑，梦回吹角连营。八百里分麾下炙，五十弦翻塞外声，沙场秋点兵。
    马作的卢飞快，弓如霹雳弦惊。了却君王天下事，赢得生前身后名，可怜白发生。

  • 区块中可以嵌套使用列表

    1.第一项
    2.第二项

  • 列表中也同样可以嵌套使用区块

• 代码引用：

  • 单行代码引用使用一个` 符号
  • 多行代码引用使用三个 ```放在代码的首行和末行，并制定一门语言（也可以不指定）
  • printf("Hello world");

    第一段代码
    第二段代码
    第三段代码
    

  • 可以使用一个制表符(Table键)来表示代码区块（使用条件有限制）

• 注释

  • 使用[^er] 来表示注释，注释在文档末尾标出。er可替换为任意名字，但必须唯一对应。

5.字体格式

• 在Markdown中，用两个 ** 包含一段文本就是粗体的语法，用一个 * 包含一段文本就是斜体的语法。如：
  斜体——醉里挑灯看剑
  粗体—— 醉里挑灯看剑
• 使用 三个 *** 代表粗斜体，如
  粗斜体—— 醉里挑灯看剑
• *可用 _ 来代替
• 用==表示高亮，如 高亮
• 下标H~2~O:H₂O; 上标2^10^:2¹⁰

6.分割线、删除线及下划线

• 在一行中使用三个及以上的 * - _ 可以建立一个分割线，行内除空格外不能有其他东西，如：---

  ---

• 使用~~添加删除线。需在文字两端添加，如 醉里挑灯看剑
• 下划线可使用HTML中的 <u> 标签来实现，如醉里挑灯看剑

7.表格的使用

• Markdown 制作表格使用 | 来分隔不同的单元格，使用 - 来分隔表头和其他行。
• 对齐方式
  • -: 设置内容和标题栏居右对齐。
  • :- 设置内容和标题栏居左对齐。
  • :-: 设置内容和标题栏居中对齐。

• Tables	Are	Cool
  col 3 is	right-aligned	$1600
  col 2 is	centered	$12
  zebra stripes	are neat	$1

8.高级技巧

• 支持HTML元素
  • 不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写
  • 目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等
  • 例子：使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑——使用 Ctrl+Alt+Del 重启电脑
• 转义
  • Markdown中使用反斜杠 \ 代表特殊转义字符。如\*\* 正常表示** 字符。
• 公式
  • 当需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。提交后，问答和文章页会根据需要加载 Mathjax 对数学公式进行渲染

---

1. 详细教程可见 Markdown | 菜鸟教程 ↩︎