Markdown 语法规则及写作工具

Markdown 是一种轻量级标记语言，通过简单符号实现文本格式化。相对于 LaTeX 这类专业的排版语言，Markdown 更简单易用，适用于笔记，博客等场景。

Markdown 的语法规则较为简单，但不同的 Markdown 解析器对语法的支持可能有所不同，本文仅对基础语法进行简单的介绍，并介绍一些常用的 Markdown 写作工具。

Markdown 语法规则

标题

使用#表示，数量对应级别。

# 一级标题

## 二级标题

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

文本样式

• • 加粗：**加粗文本** 或 __加粗文本__ → 加粗文本

• • 斜体：*斜体文本* 或 _斜体文本_ → 斜体文本

• • 粗斜体：***粗斜体文本*** 或 ___粗斜体文本___ → 粗斜体文本

• • 删除线：~~删除线文本~~ →删除线文本

• • 转义字符：使用\输出特殊符号，例如：\* 这不是斜体 \* → * 这不是斜体 *

• • 引用：使用 > 表示：> 引用文本 →

引用文本

• • 分割线：三个或更多 * 、 - 或 _，例如 ***，---，___ →

列表

无序列表

使用 -、* 或 +，示例：

- 项目1

- 项目2

- 子项目

有序列表

使用数字加点，示例：

1. 第一项

2. 第二项

1. 子项

任务列表

使用- [x] 和 - [ ]，示例：

- [x] 已完成任务

- [ ] 待办任务

图片

图片的格式可表示为，显示文本在图片无法加载时显示。可以使用本地图片地址，也可使用图床生成链接。

表格

使用 | 和 - 创建，使用 : 改变对齐方式，示例：

默认对齐

左对齐

居中对齐

右对齐

单元格内容

单元格内容

单元格内容

单元格内容

默认对齐 | 左对齐 | 居中对齐 | 右对齐 |

--- | :--- | :---: | ---: |

单元格内容 | 单元格内容 | 单元格内容 | 单元格内容 |

代码

• • 行内代码： `inline code` → inline code

• • 代码块：三个反引号包裹，可指定语言，若需要在代码块内输入三个反引号，则代码块的界定符需比内部使用更多的反引号：

```python

print("Hello, Markdown!")

```

数学公式

支持 LaTeX 语法，需依赖 MathJax 或 KaTeX 渲染。

• • 行内公式：$y = x^2$ →

• • 行间公式：$$e^{i\theta} = \cos(\theta) + i\sin(\theta)$$ →

• • 在行间公式嵌入 LaTeX 公式环境，示例：

$$

\begin{equation}

x| =

\begin{cases}

x & \text{if } x \geq 0 \\

-x & \text{if } x < 0

\end{cases}

\end{equation}

$$

• • 使用 \tag{} 命令为公式手动指定一个编号或标记，用于公式的引用和说明，\tag*{} 命令可以去除包围标签的圆括号，在引用公式时，标签需手动输入，示例：

$$

\begin{equation}

\begin{split}

e^x &= \sum_{n=0}^{\infty} \frac{x^n}{n!} \\

&= 1 + x + \frac{x^2}{2!} + \frac{x^3}{3!} + \cdots + \frac{x^n}{n!} + \cdots

\end{split}

\end{equation}

\tag*{1-1}

$$

链接

行内链接

行内链接直接在行内定义链接的文本和地址。其格式可表示为[显示文本](链接地址 "可选标题")，显示文本 是页面上显示的文字，链接地址 是链接的实际地址，"可选标题"是鼠标悬停在链接上时出现的提示文字，可以省略。

示例：

[微信官网](https://weixin.qq.com/ "微信官网") → 微信官网[1]

参考链接

当同一个链接在文章中出现多次时，使用这种方法可以方便统一管理。语法分为两部分：

• • 链接位置：在文中需要链接的地方写 [链接文字][链接标识]。

• • 链接定义：在文档的任意位置（通常放在末尾）写 [链接标识]: 真实的链接地址。

示例:

打开[微信公众平台][1]，可创建自己的公众号。

[1]:https://mp.weixin.qq.com/

自动链接

用尖括号 < > 包裹网址或邮箱地址，Markdown 会自动将其转换为可点击的链接。

脚注链接

脚注链接用于在文章底部添加解释或引用来源。语法分为两部分：

• • 添加注脚标记：在需要注释的文字后面加上 [^注脚标识]。

• • 定义注脚内容：在文档末尾（或其他位置）写 [^注脚标识]: 注脚的解释内容。

示例：

使用 Markdown[1]可以高效地写作，利用微信公众平台[2]可分享自己的文章。

1.HyperText Markup Language 超文本标记语言↩︎

2.微信公众平台: https://mp.weixin.qq.com/↩︎

使用 Markdown[^1] 可以高效地写作，利用微信公众平台[^2]可分享自己的文章。

[^1]:HyperText Markup Language 超文本标记语言

[^2]:微信公众平台: https://mp.weixin.qq.com/

锚点链接

锚点链接用于在当前文档内部进行跳转，通常需要为标题定义一个标识符，然后用普通链接语法指向它。语法分两个部分：

• • 定义锚点：在标题后加上 {#自定义锚点名称}，例如：## 章节标题 {#section1}。

• • 链接到锚点：[跳转到某一章](#section1)。

复杂样式

Markdown 本身不支持复杂样式，但可通过嵌入 HTML 标签并结合 CSS 样式实现个性化排版，核心是利用 HTML 的 style 属性或 <style> 标签定义样式。

Markdown 已实现的文本样式:

• • 加粗文本：<strong> / <b>

• • 倾斜文本：<em> / <i>

• • 删除线：<del>

• • 分割线：<hr>

• • 行内代码：<code>

• • 代码块：<pre>

• • 行内引用：<q>

• • 引用块：<blockquote>

使用 HTML 标签可实现 Markdown 无法实现的文本样式，例如：

• • 上标：^上标。X² → X2

• • 下标：_下标。Y₂ → Y2

• • 下划线：<u>下划线</u> 或 <ins>下划线</ins> → 下划线

• • 高亮文本：<mark>高亮文本</mark> →高亮文本

使用 <div> 标签下的 align 属性可以设置文本对齐方式，文本对齐示例：

这段文本居左显示

这段文本居中显示

这段文本居右显示

<div align="left">这段文本居左显示</div>

<div align="center">这段文本居中显示</div>

<div align="right">这段文本居右显示</div>

使用 <font> 标签下的 color 属性可以设置文本颜色，face 属性可以设置文本字体，size 属性可以设置文本字号，文本颜色示例：

这是红色文字

这是黄色文字

这是绿色文字

这是蓝色文字

<font color="red">这是红色文字</font>

<font color="yellow">这是黄色文字</font>

<font color="#00FF00">这是绿色文字</font>

<font color="#0000FF">这是蓝色文字</font>

Markdown 写作工具

Visual Studio Code

Visual Studio Code 简称 VS Code，是一款由微软开发的免费、开源、跨平台的代码编辑器，兼具轻量、高效和高度可定制的特性。

1. 1. 下载

2. 访问 VS Code 官网[2] 下载对应操作系统（Windows, macOS, Linux）的安装程序。

3. 2. 安装

4. 运行安装程序，按照引导进行安装。

5. 3. 语言设置

6. 启动 VS Code，使用快捷键 Ctrl+Shift+P 打开命令面板，输入“Configure Display Language”或“Chinese”，安装中文语言包并重启。

7. 4. 插件安装

8. 在扩展界面搜索并安装对应插件。

• • Markdown All in One 插件支持 Markdown 语法高亮、自动补全等，

• • Markdown Preview Enhanced 插件提供强大的 Markdown 预览功能，支持数学公式、图表等，可导出 html、pdf 等多种格式。

1. 5. 创建项目

2. 在文件系统创建相应的项目文件夹，点击 文件 → 打开文件夹，选择创建的项目文件夹并打开。在项目文件夹下创建 .md 文件，并在文件中撰写所需内容。

3. 6. 预览

4. 在文件编辑界面右键单击，选择 MPE:打开侧边预览 即可预览 Markdown 内容。右键点击侧边预览窗口可以选择 Preview Theme、Code Block Theme 和 Reveal.js Theme。

5. 7. 导出

• • html 文件

• 右键点击侧边预览窗口，选择 Export → HTML → HTML (offline) 可导出 html 文件。

• • pdf 文件

• 右键点击侧边预览窗口，选择 Export → Chrome (Puppeteer) → PDF 可导出 pdf 文件。如需显示代码块背景，在 Markdown Preview Enhanced 插件设置选项里找到 Markdown-preview-enhanced: Print Background，勾选 Whether to print background for file export or not。

• • 另存为 pdf 文件

• 右键点击侧边预览窗口，选择 Open in Browser，Ctrl+P 打印网页，选择 另存为PDF。通过勾选 背景图形 可显示代码块背景。布局、纸张大小、缩放、边距、页眉页脚可自行设置。

1. 8. 样式设置

2. 使用快捷键 Ctrl+Shift+P 打开命令面板，搜索 Markdown Preview Enhanced: Customize CSS ，带 (Global) 后缀的是设置全局样式，带 (Workspace) 后缀的是设置工作区样式。打开 Markdown Preview Enhanced: Customize CSS (Global)，通过填写代码可设置预览和打印的样式，如字体、字号、行距、背景颜色等。示例代码如下：

html body {

font-family: "思源宋体 CN Medium", "Times New Roman";

font-size: 16px;

font-weight: normal;

line-height: 1.6;

color: #000000;

background-color: #ffffff;

overflow: initial;

box-sizing: border-box;

word-wrap: break-word;

}

1. 9. 代码自动换行

2. 设置代码自动换行是为了避免导出 pdf 文件时部分代码显示不全。打开 Markdown Preview Enhanced: Customize CSS (Global)，填写如下代码即可实现代码自动换行。

.markdown-preview.markdown-preview {

// 自动换行：预览用

pre, code {

white-space: pre-wrap;

word-break: break-word;

overflow: hidden;

}

// 自动换行：打印用

@media print {

pre, code {

white-space: pre-wrap;

word-break: break-word;

overflow: hidden;

}

}

}

MarkText

MarkText 是一款专注于速度和可用性的开源 Markdown 编辑器，支持实时预览模式，还提供了源码模式、打字机模式和专注模式。

MarkText 可跨平台使用，适用于 Windows、macOS 和 Linux 三大主流桌面操作系统。可在 MarkText GitHub 主页[3] 下载。

Doocs WeChat Markdown Editor

WeChat Markdown Editor 是一款专为微信公众号文章排版设计的开源在线编辑器，可以使用 Markdown 语法写作，然后一键生成样式美观、兼容微信公众号后台的图文内容，避免了手动排版的繁琐。支持 Markdown 语法、自定义主题样式、代码高亮、数学公式、Mermaid 图表、多图床等特性。

访问 WeChat Markdown Editor 官网[4]，可在线使用。访问 doocs/md GitHub 主页[5] ，可了解源代码自行部署。

引用链接

[1] 微信官网: https://weixin.qq.com/

[2] VS Code 官网: https://code.visualstudio.com/

[3] MarkText GitHub 主页: https://github.com/marktext/marktext/

[4] WeChat Markdown Editor 官网: https://md.doocs.org/

[5] doocs/md GitHub 主页: https://github.com/doocs/md/

原文来源：https://mp.weixin.qq.com/s/Spdk7M2ttHZ0kajPocc_fg?click_id=57