Markdown 是一种轻量级标记语言，通过简单标记语法，让普通文本具备格式化效果，核心目标是「易读易写」—— 纯文本编写，无复杂标签，直接阅读也清晰易懂。
一、概述
核心特性
可读性优先：纯文本格式，无冗余标签，直接阅读也自然流畅
语法简洁：基于标点符号设计，标记与语义高度一致（如 强调 直观易懂）
兼容性强：衍生版本丰富（Markdown Extra、MultiMarkdown 等），支持扩展表格、脚注等功能，可转换为 HTML、LaTeX、Docbook 等格式
灵感来源：源自纯文本电子邮件格式，兼顾写作效率与展示效果
主要用途
撰写博客（支持 WordPress 等主流平台）
编写项目说明文档（如 README.md）
快速生成演讲 PPT、Word 文档、LaTeX 论文
数据科学领域：支持动态可重复性研究文档
二、块元素
- 段落和换行 段落：由连续行组成，空行（含仅空格/tab的行）分隔不同段落，无需缩进 强制换行：行尾加 2 个以上空格 + 回车，或用反斜线 \ + 回车
这是第一段，行尾加两个空格强制换行显示这是第二段（与上一段空行分隔）这是第三段\反斜线换行示例效果
这是第一段，行尾加两个空格
强制换行显示
这是第二段（与上一段空行分隔）
这是第三段
反斜线换行示例
- 标题 支持两种语法，推荐使用 Atx 形式（更灵活）：
Atx 形式（推荐）
# H1 一级标题## H2 二级标题### H3 三级标题#### H4 四级标题##### H5 五级标题###### H6 六级标题效果
H1 一级标题
H2 二级标题
H3 三级标题
H4 四级标题
H5 五级标题
H6 六级标题
Setext 形式（仅支持 H1-H2）
H1 一级标题===H2 二级标题---效果
H1 一级标题
H2 二级标题
- 块引言 行首加 > ，支持嵌套（多层 >）和内部嵌套其他语法 可仅在段落第一行加 >，后续行自动继承
> 一级引言段落1> 一级引言段落2>> > 嵌套二级引言>> 回到一级引言，支持嵌套列表：> 1. 引言内有序列表> 2. 列表项2>> > ## 引言内标题> > `引言内代码`效果
一级引言段落1 一级引言段落2
嵌套二级引言
回到一级引言，支持嵌套列表：
引言内有序列表
列表项2
引言内标题
引言内代码
- 列表
无序列表
支持 -、*、+ 作为标记（推荐 -），标记后需加空格
- 无序列表项1- 无序列表项2 - 嵌套子项（缩进 3 空格或 1 tab） - 嵌套子项* 星号标记项（不推荐混合使用）+ 加号标记项（不推荐混合使用）效果
- 无序列表项1
- 无序列表项2
- 嵌套子项（缩进 3 空格或 1 tab）
- 嵌套子项
- 星号标记项（不推荐混合使用）
- 加号标记项（不推荐混合使用）
有序列表
数字 + 英文句点 + 空格，数字不影响最终排序（可统一用 1.）
1. 有序列表项11. 有序列表项2 1. 嵌套子项（缩进） 2. 嵌套子项3. 有序列表项3列表高级用法列表项含多段落：子段落需缩进 3 空格列表项间空行：自动为内容添加 <p> 标签（更美观）避免误触发：行首数字+句点前加反斜线 \（如 1986\. 年份说明）
- 列表项1（含多段落） 子段落内容（缩进 3 空格） 子段落2
- 列表项2（空行分隔，自动加<p>标签）效果
- 有序列表项1
- 有序列表项2
- 嵌套子项（缩进）
- 嵌套子项
- 有序列表项3
列表高级用法
列表项含多段落：子段落需缩进 3 空格
列表项间空行：自动为内容添加标签（更美观）
避免误触发：行首数字+句点前加反斜线 \（如 1986. 年份说明）
-
列表项1（含多段落）
子段落内容（缩进 3 空格）
子段落2 -
列表项2（空行分隔，自动加p标签）
- 代码块
基础用法（缩进式）
行首缩进 4 空格或 1 tab，适用于短代码块
普通段落:
const a = 1; // 缩进 4 空格的代码块 console.log(a);进阶用法（围栏式，推荐） 用 ``` 或 ````` 包裹，支持指定语言高亮（推荐）
// 指定 JavaScript 语法高亮function demo() { return "代码块";}// 嵌套代码块（外层用更多反引号）html
<div>嵌套代码块示例</div>- 分隔线
一行内用 3 个以上
*、-、_，行内无其他内容
内容1---内容2***内容3___效果
内容1
内容2
内容3
三、行内元素
- 链接
行内链接（推荐，直观）
[链接文本](https://example.com "可选标题，hover显示")[相对路径链接](/about/ "内部页面")[无标题链接](https://example.com)效果
参考式链接（适合多次引用同一链接）
// 正文引用这是[示例链接][id1]，这是[重复引用链接][id1]
// 链接定义（可放文末）[id1]: https://example.com "可选标题"[google]: https://google.com/ "Google"
// 简化写法（链接文本=标识ID）[Google][][google]: https://google.com/效果
// 正文引用
// 链接定义（可放文末）
// 简化写法（链接文本=标识ID）
- 强调
单*或_：斜体（<em>）
双*或_：粗体（<strong>）
符号需成对使用，不可混合
*斜体文本*（推荐）_斜体文本_**粗体文本**（推荐）__粗体文本__**_粗斜体文本_**效果
斜体文本（推荐）
斜体文本
粗体文本（推荐）
粗体文本
粗斜体文本
- 行内代码 用反引号 ` 包裹，含反引号时用多组反引号
行内代码：`console.log("hello")`含反引号的代码：`` `code` 中的反引号 ``HTML 标签示例：`<div class="demo">`效果
行内代码：console.log("hello")
含反引号的代码：`code` 中的反引号
HTML 标签示例：<div class="demo">
- 图片
语法与链接类似，前缀加 !，无宽高控制语法（需宽高时用
<img>标签）
行内图片
参考式图片
![替代文本][imgId][imgId]: /path/to/img.webp "可选标题"
自定义宽高（HTML 标签）
<img src="/path/to/img.webp" alt="替代文本" width="300" height="200">
- 其他行内样式
| 效果 | Markdown语法 | 说明 |
|---|---|---|
| 删除线 | ~~删除文本~~ | 双波浪线包裹 |
| 换行 | 行尾加 2 空格 + 回车 | 强制换行 |
| 表情符号 | :emoji名称: | 例：:smile: → 😄 |
四、扩展功能
- 表格
- 表头与内容用
-分隔，:控制对齐（无:则默认左对齐） -数量至少 1 个，可灵活调整
| 左对齐 | 居中对齐 | 右对齐 |
|---|---|---|
| 内容1 | 内容2 | 内容3 |
| 长文本内容 | 居中示例 | 数值100 |
- 自动链接
无需标记文本，直接用 <> 包裹网址或邮箱
<https://example.com><contact@example.com>https://example.com
contact@example.com
- 转义字符 用反斜线 \ 转义 Markdown 特殊符号，支持转义的符号：
\ 反斜线` 反引号* 星号_ 底线{} 大括号[] 方括号() 括号# 井字号+ 加号- 减号. 英文句点! 惊叹号示例：*这不是斜体* → 这不是斜体
- 行内 HTML
支持直接插入 HTML 标签，块级标签需前后空行，且不缩进
普通段落
<div style="color: red;">HTML 块级标签，前后空行</div>
<span style="color: blue;">行内 HTML 标签</span>注意：HTML 块内不解析 Markdown 语法
- 快捷键
| 效果 | Markdown 语法 | 快捷键（Windows/Linux） | 快捷键（Mac） |
|---|---|---|---|
| 粗体 | **文本** | Ctrl + B | ⌘ + B |
| 斜体 | *文本* | Ctrl + I | ⌘ + I |
| 行内代码 | 代码 | 选中内容 + | 选中内容 + |
| 链接 | [文本](链接) | Ctrl + K | ⌘ + K |
| 图片 |  | Ctrl + Shift + I | ⌘ + Shift + I |
五、注意事项
- 语法兼容性：不同平台（GitHub、掘金等）对扩展语法（如表格、脚注）支持有差异，需按需调整
- 图片路径：遵循前端资源路径规则（/ 开头对应 public 目录，无 / 对应相对目录）
- 性能优化：图片推荐用 WebP 格式，文档中避免冗余标记，保持可读性
如果这篇文章对你有帮助，欢迎分享给更多人！