-
唯一的限制是那些块级HTML元素,如
<div>
,<table>
,<pre>
,<p>
等,必须使用空行与相邻内容分开,并且块元素的开始和结束标签之前不要留有空格或 TAB。 -
不要在块级 HTML 元素内使用 Markdown 格式化命令,但对于行内标签,比如
<span>
,<del>
等,你可以随便用,如果需要,甚至可以使用<a>
标签来代替 Markdown 自身的链接或图片语法。 -
不同于这些块级 HTML 元素,在 HTML 行内元素内的 Markdown 语法标记会被正确处理。
-
在 Mardown 代码行内标记和块级标记之中,
<
和&
始终会被自动编码。这使得在 Markdown 文件中书写 HTML 代码更容易。 -
正常的段落不要以空白或 TAB 字符开始。
-
如果你确实需要使用 Markdown 插入一个
<br />
换行符,只需要在每一行的末尾以两个或更多个空格符号结束,然后再打回车键。 -
Setext 风格的标题:
=====
(至少有一个=
和-
就能正常工作),Atx 风格的标题:#、##
(对应h1 - h6
) -
有序列表使用数字加英文句点,无序列表可以使用星号、加号和连字符,在列表中输入的标记数字并不会反映到 Markdown 输出的 HTML 之中)
-
列表标记通常从左边界开始,至多可以有三个空格的缩进。列表标记之后至少要跟一个空格或 TAB。
-
要在列表项中使用代码块,代码块需要缩进两次即
8
个空格或者两个 TAB。代码块在遇到没有缩进的一行,或者文件末尾时自动结束。在代码块中,&
符号和<
、>
会自动转换成 HTML 实体。 -
隐式连接标识可以允许省略标识本身,这是连接文本本身就是连接标识。链接可以放在文档的任意位置,但是建议是放在最先使用它的段落之后。
-
要在行内表示部分代码,用反引号 ` 包住它。包住行内代码的反引号定界符可以包括空格(即在起始反引号之后,结束反引号之前可以有一个空格)。这使得我们能够在行内代码的开始或结束处使用反引号。在行内代码中,
&
和<
和>
会自动编码为 HTML 实体,以方便包含 HTML 标签。 -
图片的表示法类似链接,也分为行内和引用两种表示方法,区别就是对于图片而言,开头是个感叹号。 直接使用尖括号包住链接或者邮件地址,MarkDown 会自动识别并显示。
Markdown语法的一些难记住的点
回顾一些容易忘记的语法点。
- Link: https://sharryxu.com/posts/some-confused-point-in-markdown/
- License: © Sharry