举报该广告

违法/违规内容 虚假/诈骗信息 涉黄/暴力 其他 / 自定义...

取消 提交

一份涵盖几乎所有 Markdown 元素（含 GFM 扩展）的参考文档，同时也是自举示例——本文档本身就用到了所有你将会看到的语法。

✨ 基础文本样式

• 粗体：**粗体** 或 __粗体__
• 斜体：*斜体* 或 _斜体_
• 粗斜体：***粗斜体***
• 删除线：~~删除线~~（GFM）
• 下划线：使用 HTML 标签 <u>
• 行内代码：print("Hello") 使用反引号

📌 标题与段落

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

段落之间用空行分隔。
如果要在段落内换行，在行末加两个空格（或使用 <br>）。

📋 列表（有序 / 无序 / 嵌套）

无序列表

• 苹果
• 香蕉
  • 子项（缩进 2 或 4 空格）
  • 更深一层
• 橙子

有序列表

1. 第一步
2. 第二步
   1. 子步骤 1
   2. 子步骤 2
3. 第三步

混合列表

• [ ] 待办（任务列表）
• [x] 已完成

🔗 链接与图片

链接

• 普通链接
• 带标题的链接
• 自动链接：https://www.example.com
• 引用式链接：Google 和 Bing

图片

图片也可以是引用式：

💻 代码（行内 / 块级）

行内代码

使用 print("Hello") 输出。

代码块（带语法高亮）

def greet(name):
    """Say hello"""
    return f"Hello, {name}!"

# 测试
print(greet("Markdown"))

// JavaScript 示例
const add = (a, b) => a + b;
console.log(add(2, 3));

# 终端命令
npm install -g markdown

纯文本块（无语言）

这是一个普通的文本块，
不会高亮。

📊 表格

表格列数必须一致，对齐方式由 : 位置决定。

💬 引用块

这是一级引用。

这是嵌套引用。

这是三级引用，可以包含其他 Markdown 元素，如 粗体 或 代码。

✅ 任务列表

• [x] 编写文档大纲
• [x] 完成基础语法部分
• [ ] 补充高级扩展
• [ ] 发布到网站
  • [ ] 检查所有链接
  • [ ] 添加互动示例

🦶 脚注

这里是一个脚注示例[^1]，还有另一个^2。

[^1]: 这是第一个脚注的内容，可以很长，甚至包含 格式。

🖌 删除线 / 高亮 / 下标 / 上标

• 删除线：~~删除线~~
• ==高亮==（GFM 不支持，但部分编辑器如 Typora 支持，或使用 HTML <mark>）
• H~2~O（下标）：H~2~O（需启用扩展，或使用 <sub>）
• X^2^（上标）：X^2^（或 <sup>）

更通用的 HTML 写法：

• 高亮 → <mark>高亮</mark>
• _下标 → <sub>下标</sub>
• ^上标 → <sup>上标</sup>

➖ 水平线

以下三种方式均可（单独一行）：

😊 Emoji 与 HTML 标签

Emoji（GFM 支持）

:smile: :rocket: :heart: :+1: :tada:
也可以直接复制 Emoji 字符：🎉 💻 🔥

常用 HTML 标签（允许）

• 换行：<br>
• 键盘：Ctrl + C
• 粗体/斜体替代（但推荐用 Markdown 语法）
• 字体颜色（不推荐，但可用）：红色
• 注释：

🧪 GitHub 特有语法

提及用户

@octocat ：提到用户，会发送通知。

Issue/PR 引用

• 引用 Issue：#123
• 引用 PR：#456
• 交叉仓库：owner/repo#789

折叠块（

）

警告框（GitHub 风格，通过 blockquote 模拟）

[!NOTE]
这是一个提示信息。

[!WARNING]
这是一个警告。

[!IMPORTANT]
重要事项。

🧾 结语

本文档覆盖了绝大多数 Markdown 语法，包括基础扩展和 GitHub 特色。
你可以直接复制本文内容，作为自己项目的 README.md 或写作模板。
如有遗漏，欢迎补充！

最后更新：2026-07-24
作者：Markdown 爱好者
许可证：CC BY 4.0