Markdown 术语表

专有名词注释查阅表 | 1 个分类

Markdown-专有名词注释查阅表 | Markdown

1. 基础概念类

1.1 Markdown

名称:Markdown 标记语言(Markdown)

首次出现位置:C09_101-Markdown概述.md 第1章 定义

Markdown 是 John Gruber 于 2004 年创建的轻量级标记语言,使用简洁的语法编写格式化文本,可转换为 HTML 或其他格式。

详解: 设计哲学:可读性优先,标记语言应如同普通文本般易读。应用场景:README 文档、博客文章、论坛帖子、笔记软件、在线文档。优势:纯文本编写、无需专有软件、容易学习、广泛支持。变体:CommonMark(标准化)、GitHub Flavored Markdown(GFM)、MultiMarkdown、Pandoc Markdown。工具支持:VS Code、Typora、Markdown Here、作业部落、有道云笔记。


1.2 John Gruber(约翰·格鲁伯)

名称:约翰·格鲁伯(John Gruber)

首次出现位置:C09_101-Markdown概述.md 第1章 定义

John Gruber 是美国程序员和作家,Markdown 的创始人,与 Aaron Swartz 共同创建了该语言。

详解: 2004 年与 Aaron Swartz 共同设计 Markdown。博客:Daring Fireball(苹果相关科技博客)。语法设计原则:Markdown 标记应尽可能类似其表示的格式。


1.3 轻量级标记语言

名称:轻量级标记语言(Lightweight Markup Language)

首次出现位置:C09_101-Markdown概述.md 第1章 定义

轻量级标记语言使用简单直观的语法,比 XML/HTML 等传统标记语言更易于人类读写。

详解: 特点:语法简洁、学习曲线平缓、转换灵活。常见语言:Markdown、reStructuredText、AsciiDoc、Textile。对比 HTML:HTML 标签冗长,Markdown 简洁优雅。转换:Markdown 可转换为 HTML、PDF、DOCX、LaTeX 等格式。


1.4 纯文本

名称:纯文本(Plain Text)

首次出现位置:C09_101-Markdown概述.md 第1章 定义

纯文本是只包含标准字符集(字母、数字、标点、符号)的文本文件,不包含任何格式信息。

详解: 文件格式:.txt、.md、.markdown。优势:通用性强、任何编辑器可打开、版本控制友好、跨平台兼容。Markdown 的纯文本可读性:即使不渲染,也能大致了解文档结构。


2. 基础语法类

2.1 标题(Heading)

名称:标题(Heading)

首次出现位置:C09_102-标题语法.md 第1章 定义

标题用于创建文档的层级结构,Markdown 使用 # 符号表示不同级别的标题。

详解: 语法:# 一级标题、## 二级标题、### 三级标题、#### 四级标题、##### 五级标题、###### 六级标题。推荐写法:标题前后留空行。ATX 风格:# 标题 行首 # 加空格。闭合标签:Setext 风格用下划线表示(已较少使用)。SEO 重要性:搜索引擎重视 H1-H6 标题层级。


2.2 段落(Paragraph)

名称:段落(Paragraph)

首次出现位置:C09_103-段落与换行.md 第1章 定义

段落是文本的基本组成单位,Markdown 中以空行分隔的连续文本被视为一个段落。

详解: 创建:连续文本以空行分隔即构成段落。换行:行末两个空格 + 换行,或使用 <br> 标签。缩进:Markdown 不支持段落首行缩进(可用 HTML <p style="text-indent: 2em;">)。多段落:段落间用空行分隔。


2.3 换行(Line Break)

名称:换行(Line Break)

首次出现位置:C09_103-段落与换行.md 第2章 定义

Markdown 中的换行表示文本在同一段落内另起一行。

详解: 方法一:行末加两个空格。方法二:使用 <br> HTML 标签。方法三:直接回车(部分解析器支持)。硬换行 vs 软换行:部分渲染器区分。支持情况:各 Markdown 处理器支持程度不同,建议使用两个空格。


2.4 强调(Emphasis)

名称:强调(Emphasis)

首次出现位置:C09_104-文本格式.md 第1章 定义

Markdown 使用 * 或 _ 创建斜体,使用 ** 或 __ 创建粗体,使用 ~~ 创建删除线。

详解: 斜体:*italic*_italic_。粗体:**bold**__bold__。粗斜体:***bold italic***___bold italic___。删除线:GFM 支持,~~strikethrough~~。嵌套规则:可以混合使用,但需正确嵌套。转义:使用反斜杠 \* 显示星号。


2.5 引用(Blockquote)

名称:引用块(Blockquote)

首次出现位置:C09_104-文本格式.md 第2章 定义

引用块用于标注引用的文本,Markdown 使用 > 符号创建引用块。

详解: 语法:> 引用的文本。多行:每行前加 > 或只在第一行加 >。嵌套引用:多层 >> 嵌套。包含其他元素:引用块内可包含其他 Markdown 元素(标题、列表、代码块)。样式:通常有左侧竖线和缩进。学术引用:常用于引用文献或他人言论。


2.6 水平线(Horizontal Rule)

名称:水平线(Horizontal Rule)

首次出现位置:C09_104-文本格式.md 第3章 定义

水平线用于分隔文档内容,Markdown 使用三个以上的 -、* 或 _ 创建水平线。

详解: 语法:三个或更多 -*_,可加空格。示例:---***___。推荐:使用 - 作为标准。注意:与标题区分,- 后需接空格或文本。渲染:通常显示为细水平线。


3. 列表语法类

3.1 无序列表(Unordered List)

名称:无序列表(Unordered List)

首次出现位置:C09_105-列表语法.md 第1章 定义

无序列表使用 -、* 或 + 创建项目符号列表。

详解: 语法:- 项目* 项目+ 项目。推荐:建议统一使用一种符号。嵌套:使用四个空格或一个 Tab 创建子列表。列表内换行:行末两空格或使用 <br>。空行:列表前后可加空行增加可读性。


3.2 有序列表(Ordered List)

名称:有序列表(Ordered List)

首次出现位置:C09_105-列表语法.md 第1章 定义

有序列表使用数字加句点创建带顺序编号的列表。

详解: 语法:1. 第一项2. 第二项。编号:Markdown 会自动计算,即使写成 1. 1. 1. 也会正确渲染。起始编号:部分解析器支持指定起始数字。嵌套:与无序列表相同的嵌套规则。


3.3 任务列表(Task List)

名称:任务列表(Task List / Todo List)

首次出现位置:C09_105-列表语法.md 第2章 定义

任务列表(Todo List)是 GFM 扩展,支持创建可勾选的任务项。

详解: 语法:- [ ] 未完成- [x] 已完成。方括号内:空格或 x 表示状态。大小写:部分解析器大小写敏感。应用:项目规划、待办事项追踪。样式:渲染后通常显示为复选框。


3.4 嵌套列表

名称:嵌套列表(Nested List)

首次出现位置:C09_105-列表语法.md 第1章 定义

列表可以嵌套以创建层级结构,子列表比父列表缩进更深。

详解: 缩进:四个空格或一个 Tab。混合嵌套:无序列表和有序列表可相互嵌套。列表内容:嵌套列表内可包含段落、代码块等。深度:可多级嵌套,但过深会影响可读性。


4. 代码语法类

4.1 行内代码(Inline Code)

名称:行内代码(Inline Code)

首次出现位置:C09_107-代码块与语法高亮.md 第1章 定义

行内代码用于在段落中标记简短的代码或命令,使用反引号 ` 包裹。

详解: 语法:`code`。转义:代码中包含反引号可用双反引号包裹。空白:行内代码首尾空格会被保留。应用:文件名、函数名、命令行、环境变量。


4.2 代码块(Code Block/Fenced Code Block)

名称:代码块(Code Block)

首次出现位置:C09_107-代码块与语法高亮.md 第2章 定义

代码块用于标记多行代码或文本,GFM 使用三个反引号创建围栏代码块。

详解: 围栏代码块:language 开始, 结束。缩进代码块:四个空格缩进的文本(已不推荐)。语言标识:后指定语言如javascript。语法高亮:支持语法高亮的渲染器会高亮代码。空白:围栏代码块内首行尾行可空行。


4.3 语法高亮(Syntax Highlighting)

名称:语法高亮(Syntax Highlighting)

首次出现位置:C09_107-代码块与语法高亮.md 第2章 定义

语法高亮是根据代码语言对代码块进行着色,提高可读性。

详解: 实现:依赖 Prism.js、highlight.js 等库。常用语言:javascript、python、java、cpp、html、css、sql、bash。通用标识:使用 ```text```plain 无高亮。高亮主题:不同主题影响颜色方案。GFM 支持:GitHub 支持多种语言的语法高亮。


4.4 转义字符(Escape Character)

名称:转义字符(Escape Character)

首次出现位置:C09_107-代码块与语法高亮.md 第3章 定义

转义字符用于在 Markdown 中显示被语法占用的特殊字符。

详解: 反斜杠:\* 显示 *。星号:显示星号不产生强调。数字序号:列表中 1986\. 不触发有序列表。方括号:链接中 \[text\] 不触发链接语法。反引号:“绕反引号包围的代码`。


5. 链接与图片类

名称:链接(Link)

首次出现位置:C09_106-链接与图片.md 第1章 定义

Markdown 链接用于创建可点击的链接,链接目标可以是 URL、文件路径或锚点。

详解: 行内链接:[text](url)。自动链接:<url> 自动转换为可点击链接。相对路径:[text](./path/to/file)。链接标题:悬停显示的提示文字 [text](url "title")。Email 链接:<email@example.com>


5.2 图片(Image)

名称:图片(Image)

首次出现位置:C09_106-链接与图片.md 第2章 定义

Markdown 图片语法与链接类似,但前方加 !,图片不会内联显示而是渲染为图片。

详解: 语法:![alt](url)。Alt 文本:图片无法显示时的替代文本。标题:与链接相同的标题语法 ![alt](url "title")。引用式:![alt][ref] + [ref]: url。本地图片:使用相对路径 ![img](./images/photo.jpg)


5.3 引用式链接

名称:引用式链接(Reference-style Link)

首次出现位置:C09_106-链接与图片.md 第1章 定义

引用式链接将 URL 定义在文档其他位置,链接处使用引用标记。

详解: 定义:[ref]: url "title"。使用:[text][ref][text][](隐式引用)。优势:URL 集中管理、文档更整洁、便于批量修改。放置位置:通常放在文档末尾或脚注区域。


5.4 锚点(Anchor)

名称:锚点(Anchor)

首次出现位置:C09_106-链接与图片.md 第3章 定义

锚点用于链接到页面内的特定位置,常用于长文档的目录导航。

详解: 创建锚点:## Title {#custom-id}(部分解析器支持)。自动生成:多数解析器自动为标题生成 ID。链接到锚点:[text](#section-name)[text](#custom-id)。特殊字符:空格用 - 替代、大小写通常转小写。跨页锚点:[text](./other.md#section)


6. 表格语法类

6.1 表格(Table)

名称:表格(Table)

首次出现位置:C09_108-表格.md 第1章 定义

表格是 GFM 扩展功能,使用管道符 | 和横杠 - 创建表格结构。

详解: 语法:

 | Header | Header |
 |--------|--------|
 | Cell | Cell |

对齐:|:---| 左对齐、|---:| 右对齐、|:---:| 居中。列数匹配:每行列数必须一致。表头分隔:第二行决定列数和格式。

6.2 单元格

名称:单元格(Cell)

首次出现位置:C09_108-表格.md 第1章 定义

单元格是表格的基本单元,每行用 | 分隔的文本构成单元格。

详解: 内容:对齐文本、链接、行内代码等。引用样式:|| 可创建空单元格。转义:在单元格内显示 | 用 \|。合并单元格:Markdown 原生不支持,通常用 HTML 实现。


6.3 对齐

名称:表格对齐(Alignment)

首次出现位置:C09_108-表格.md 第2章 定义

表格支持左对齐、居中对齐、右对齐三种对齐方式。

详解: 左对齐::---。居中::---:。右对齐:---:。默认:一般左对齐。分隔行:|---|---| 表示全左对齐。


7. GFM 扩展类

7.1 GFM(GitHub Flavored Markdown)

名称:GitHub 风格 Markdown(GitHub Flavored Markdown)

缩写:GFM 首次出现位置:G09_201-核心语法汇总.md 第1章

定义

GFM 是 GitHub 对标准 Markdown 的扩展,增加了任务列表、围栏代码块、表格、自动链接等特性。

详解: 主要扩展:任务列表、围栏代码块、表格、删除线、自动链接、锚点 ID。规范文档:GitHub 官方 GFM 规范文档。兼容 Markdown:GFM 兼容标准 Markdown。广泛应用:GitHub、GitLab 等平台均支持。


名称:自动链接(Autolink)

首次出现位置:G09_201-核心语法汇总.md 第1章 定义

GFM 自动将 URL 和邮箱地址转换为可点击链接,无需使用方括号语法。

详解: URL 自动链接:<https://example.com> 自动转换为链接。邮箱自动链接:<email@example.com> 自动转换为mailto链接。禁止自动链接:部分环境出于安全考虑禁用。优势:简化 URL 书写。


7.3 删除线(Strikethrough)

名称:删除线(Strikethrough)

首次出现位置:G09_201-核心语法汇总.md 第1章 定义

删除线是 GFM 扩展,使用 ~~ 包裹文本显示删除线效果。

详解: 语法:~~deleted text~~。渲染效果:文字中间有横线。用途:表示已废弃内容、修正错误。Markdown 原生不支持:标准 Markdown 没有删除线语法。


8. 高级语法类

8.1 脚注(Footnote)

名称:脚注(Footnote)

首次出现位置:G09_202-Markdown高级语法与文档自动化.md 第1章 定义

脚注用于在文档中添加注释或引用说明,在页面底部显示。

详解: 语法:创建脚注 [^1],在文档某处定义 [^1]: footnote content。Pandoc Markdown 风格。渲染效果:脚注通常显示在页面底部或右侧。部分解析器支持:需要扩展支持的渲染器。


8.2 定义列表

名称:定义列表(Definition List)

首次出现位置:G09_202-Markdown高级语法与文档自动化.md 第1章 定义

定义列表用于展示术语及其定义,常见于词典或术语表。

详解: 语法:Pandoc Markdown 支持。术语独占一行,下一行以 : 开头接定义。适用场景:术语解释、词汇表。渲染效果:术语加粗,定义缩进。


8.3 数学公式

名称:数学公式(Mathematical Formula)

首次出现位置:G09_202-Markdown高级语法与文档自动化.md 第2章 定义

Markdown 可通过 MathJax、KaTeX 等渲染器支持数学公式。

详解: 行内公式:$equation$。块级公式:$$equation$$。LaTeX 语法:支持 LaTeX 数学表达式。渲染器:MathJax(Web)、KaTeX(更快)。应用:学术文档、技术博客、统计报告。


8.4 UML 图

名称:UML 图(UML Diagram)

首次出现位置:G09_202-Markdown高级语法与文档自动化.md 第3章 定义

Markdown 可嵌入 Mermaid、PlantUML 等工具绘制 UML 类图、流程图等。

详解: Mermaid:```mermaid 代码块内写 Mermaid 语法。PlantUML:```plantuml 代码块内写 PlantUML 语法。图表类型:流程图、时序图、类图、状态图、甘特图。应用:架构文档、技术设计文档。


8.5 目录生成

名称:目录生成(Table of Contents)

首次出现位置:G09_202-Markdown高级语法与文档自动化.md 第4章 定义

Markdown 文档工具可以自动从标题生成目录导航。

详解: VS Code 插件:Markdown All in One 可自动生成目录。Pandoc:使用 --toc 选项生成目录。GitHub:GitHub 仓库根目录的 README 自动生成目录(部分情况)。手动目录:使用链接和锚点手动创建目录。


9. 工具与生态类

9.1 CommonMark

名称:通用 Markdown(CommonMark)

首次出现位置:G09_201-核心语法汇总.md 第1章 定义

CommonMark 是 Markdown 的标准化实现,由 John MacFarlane 发起,旨在消除 Markdown 实现的混乱。

详解: 规范文档:详细的语法规范和测试用例。参考实现:C 参考实现可用于测试。Markdown 变体:许多实现基于 CommonMark 规范。官方网站:commonmark.org。


9.2 Pandoc

名称:Pandoc 文档转换器(Pandoc)

首次出现位置:G09_202-Markdown高级语法与文档自动化.md 第4章 定义

Pandoc 是强大的文档格式转换器,支持 Markdown、HTML、LaTeX、DOCX、PDF 等多种格式互转。

详解: 安装:Haskell 平台,可下载预编译版本。用法:pandoc input.md -o output.docx。参数:-s 生成完整文档、--toc 生成目录。模板:可自定义输出模板。扩展支持:支持比标准 Markdown 更多的扩展语法。


9.3 VS Code Markdown 扩展

名称:VS Code Markdown 扩展(VS Code Markdown Extensions)

首次出现位置:G09_202-Markdown高级语法与文档自动化.md 第4章 定义

VS Code 提供丰富的 Markdown 扩展,支持预览、目录生成、拼写检查等功能。

详解: Markdown All in One:自动目录、公式支持、快捷键。Markdown Preview Enhanced:增强预览、幻灯片、导出。Markdownlint:代码风格检查和规范。Prettier:格式化 Markdown 文件。


10. 最佳实践类

10.1 Markdown 风格指南

名称:Markdown 风格指南(Markdown Style Guide)

首次出现位置:G09_201-语法汇总.md 第2章 定义

Markdown 风格指南提供一致性和可读性的写作规范

详解标题层级:避免级(如 H1 后直接 H3)。列表嵌套:建议不超过三层。代码块:始终指定语言链接:优先使用引用式链接维护性。空标记文本间加空


10.2 可移植性

名称可移植性(Portability)

首次出现位置:G09_201-语法汇总.md 第2章 定义

Markdown可移植性Markdown 文件在不同工具平台间的兼容程

详解标准语法:仅使用标准 Markdown 确保最大兼容性GFM 扩展:了解 GFM标准 Markdown 的差异。图片路径:相对路径增强可移植性平台差异:GitHub、GitLab、Bitbucket 支持略有不同。


更新日志

  • 2026-04-30:创建专有名词解释文档,v1.0.0
专注模式