Markdown语法简介

Posted 2023-02-04 楚弋川

概述

Markdown 是一个 Web 上使用的文本到html的转换工具，可以通过简单、易读易写的文本格式生成结构化的HTML文档。一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布，并且看起来不会像是由许多标签或是格式指令所构成。

Markdown 并非要取代 HTML，而是以一种简单的书写格式，实现一种更加友好的页面呈现，并且，如果所需的标签不在 Markdown 涵盖范围之内，可以直接在文档里面用 HTML 撰写。但要制约的只有一些 HTML 区块元素――比如 <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。

另外 Markdown 的生成器有足够智能，不会在 HTML 区块标签外加上不必要的 <p> 标签，且书写时一定要在 Markdown 标签和内容之间加上空格，例如：# 标题

基本标签

段落

一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行（空行的定义是显示上看起来像是空的，便会被视为空行。比方说，若某一行只包含空格和制表符，则该行也会被视为空行）。

如图所示：

换行

Markdown 允许段落内的强迫换行，例如直接插入换行符<br/>，如果你确实想要依赖 Markdown 的格式来换行的话，可以在插入处先按入两个以上的空格或者至少一个 Tab 键，然后回车即可。

如图所示：

缩进

普通段落不该用空格或制表符来缩进，因为用了也无效，可以通过在段落前添加需要的空格编码，已达到显示效果。

• 半角空格   或  

• 全角空格   或  

• 不断行空格   或  

如图所示：

标题

Markdown 支持两种标题的语法，类 Setext 和类 atx 形式。

• 类 Setext 形式是用底线的形式，利用任意数量的 = （一级标题）和 - （二级标题）

• 类 Atx 形式则是在行首插入 1 到 6 个 # ，对应到标题 一级 到 六级

如图所示：

列表

Markdown 支持有序列表和无序列表。

• 无序列表使用星号、加号或是减号作为列表标记

• 有序列表则使用数字接着一个英文句点，如果排序错乱，Markdown 仍会以第一个数字进行排序，所以，第一个项目最好还是从 1. 开始

区块引用

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。

• 可以自己先将内容断好行，然后在每行的最前面加上在每一行加上 > ，如区块引用1

• 也允许你偷懒只在整个段落的第一行最前面加上 > ，如区块引用2

• 区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 > ，如区块引用2，3

如图所示：

代码

• 如果要标记一小段行内代码，你可以用反引号把它包起来，如： `代码`

• 如果要在代码区段内插入反引号，你可以用多个反引号来开启和结束代码区段

• 代码区段的起始和结束端都可以放入一个空白，起始端后面一个，结束端前面一个，这样你就可以在区段的一开始就插入反引号

• 在代码区段内，& 和方括号都会被自动地转成 HTML 实体，这使得插入 HTML 原始码变得很容易

如图所示：

代码区块

在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以

如图所示：

超链接

超链接允许两种样式： 行内式和参考式。

行内式的形式为：

• 方括号（前面可以选择性地加上至多三个空格来缩进），里面输入链接文字
• 接着一个冒号
• 接着一个以上的空格或制表符
• 接着链接的网址
• 选择性地接着 title 内容，可以用单引号、双引号或是括弧包着，最好使用双引号

参考式的形式为：

• 在链接文字的括号后面再接上另一个方括号
• 而在第二个方括号里面要填入用以辨识链接的标记

如图所示：

图片

Markdown 使用一种和链接很相似的语法来标记图片，同样也允许两种样式： 行内式和参考式。

其形式为：

• 一个惊叹号 !
• 接着一个方括号，里面放上图片的替代文字
• 接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上 选择性的 title 文字。

如图所示：

表格

Markdown 的表格格式虽然简单，但制作起来是很不容易的。

如图所示：

强调

Markdown 使用星号 * 和底线 _ 作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 <em> 标签包围，用两个 * 或 _ 包起来的话，则会被转成 <strong>。但是，如果你的 * 或 _ 两边都有空白的话，它们就只会被当成普通的符号。

如图所示：

分隔线

Markdown 允许在一行中用三个以上的星号、减号、底线来建立一个分隔线，也可以在星号或是减号中间插入空格，但行内不能有其他东西。

如图所示：

其他

反斜杠

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

\\ 反斜线
` 反引号
* 星号
_ 底线
花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来， Markdown 就会自动把它转成链接
<http://baidu.com/>

如图所示：

特殊字符

在 HTML 文件中，有两个字符需要特殊处理： < 和 & 。 < 符号用于起始标签，& 符号则用于标记 HTML 实体，如果你只是想要显示这些字符的原型，你必须要使用实体的形式 < 和 &。但是 code 范围内，不论是行内还是区块， < 和 & 两个符号都一定会被转换成 HTML 实体

推荐

MarkDown 中文

VSCode 代码编辑器