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. 链接与图片类
5.1 链接(Link)
名称:链接(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 文本:图片无法显示时的替代文本。标题:与链接相同的标题语法 。引用式:![alt][ref] + [ref]: url。本地图片:使用相对路径 。
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 等平台均支持。
7.2 自动链接(Autolink)
名称:自动链接(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