Markdown语法的一些难记住的点

回顾一些容易忘记的语法点。
  1. 一的限制是那些块级HTML元素,如 <div><table><pre><p> 等,必须使用空行与相邻内容分开,并且块元素的开始和结束标签之前不要留有空格或 TAB。

  2. 不要在块级 HTML 元素内使用 Markdown 格式化命令,但对于行内标签,比如 <span><del> 等,你可以随便用,如果需要,甚至可以使用 <a> 标签来代替 Markdown 自身的链接或图片语法。

  3. 不同于这些块级 HTML 元素,在 HTML 行内元素内的 Markdown 语法标记会被正确处理。

  4. 在 Mardown 代码行内标记和块级标记之中,<& 始终会被自动编码。这使得在 Markdown 文件中书写 HTML 代码更容易。

  5. 正常的段落不要以空白或 TAB 字符开始。

  6. 如果你确实需要使用 Markdown 插入一个 <br /> 换行符,只需要在每一行的末尾以两个或更多个空格符号结束,然后再打回车键。

  7. Setext 风格的标题:=====(至少有一个 =- 就能正常工作),Atx 风格的标题:#、##(对应 h1 - h6

  8. 有序列表使用数字加英文句点,无序列表可以使用星号、加号和连字符,在列表中输入的标记数字并不会反映到 Markdown 输出的 HTML 之中)

  9. 列表标记通常从左边界开始,至多可以有三个空格的缩进。列表标记之后至少要跟一个空格或 TAB。

  10. 要在列表项中使用代码块,代码块需要缩进两次即 8 个空格或者两个 TAB。代码块在遇到没有缩进的一行,或者文件末尾时自动结束。在代码块中, & 符号和 <> 会自动转换成 HTML 实体。

  11. 隐式连接标识可以允许省略标识本身,这是连接文本本身就是连接标识。链接可以放在文档的任意位置,但是建议是放在最先使用它的段落之后。

  12. 要在行内表示部分代码,用反引号 ` 包住它。包住行内代码的反引号定界符可以包括空格(即在起始反引号之后,结束反引号之前可以有一个空格)。这使得我们能够在行内代码的开始或结束处使用反引号。在行内代码中, &<> 会自动编码为 HTML 实体,以方便包含 HTML 标签。

  13. 图片的表示法类似链接,也分为行内和引用两种表示方法,区别就是对于图片而言,开头是个感叹号。 直接使用尖括号包住链接或者邮件地址,MarkDown 会自动识别并显示。

updatedupdated2023-12-052023-12-05