Markdown 语法指南

为初学者打造的终极图文教程。轻量、高效、易读,让写作回归纯粹。

什么是 Markdown?

Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后将其转换成有效的 XHTML(或者 HTML)。

优点: 专注写作、格式统一、跨平台兼容、Git 友好。

💡 快速了解
诞生时间:2004年由 John Gruber 创建
文件扩展名:.md 或 .markdown
应用场景:技术文档、博客写作、README 文件、笔记记录等

基础语法详解

标题 (Headers)

使用 # 号可表示 1-6 级标题,# 号数量对应标题级别。

Markdown 写法
# 一级标题 ## 二级标题 ### 三级标题
渲染效果预览

一级标题

二级标题

三级标题

段落与换行

段落之间使用空行隔开。如果需要在段落内强制换行,请在行尾加两个空格。

Markdown 写法
这是第一段。 这是第二段。 这是一行文字 (这里有两个空格) 这是换行后的文字。
渲染效果预览

这是第一段。

这是第二段。
这是一行文字
这是换行后的文字。

文本强调
Markdown 写法
**粗体文本** *斜体文本* ~~删除线~~
渲染效果预览
粗体文本
斜体文本
删除线
列表
Markdown 写法
- 无序列表项 1 - 无序列表项 2 - 嵌套列表项 2.1 - 嵌套列表项 2.2 1. 有序列表项 1 2. 有序列表项 2 1. 嵌套有序列表 2.1 2. 嵌套有序列表 2.2
渲染效果预览
  • 无序列表项 1
  • 无序列表项 2
    • 嵌套列表项 2.1
    • 嵌套列表项 2.2
  1. 有序列表项 1
  2. 有序列表项 2
    1. 嵌套有序列表 2.1
    2. 嵌套有序列表 2.2
引用
Markdown 写法
> 这是一段引用文本。 > 知识就是力量。
渲染效果预览
这是一段引用文本。
知识就是力量。
代码
Markdown 写法
行内代码:`print()` 代码块: ```python def hello(): print("Hi") ```
渲染效果预览
行内代码:print()
def hello():
    print("Hi")
水平分割线

使用三个或更多的短横线、星号或下划线。

Markdown 写法
--- *** ___
渲染效果预览

转义字符

使用反斜杠 \ 转义 Markdown 特殊字符,使其显示为普通字符。

Markdown 写法
\* 不是列表 \# 不是标题 \[link\] 不是链接
渲染效果预览
* 不是列表
# 不是标题
[link] 不是链接

进阶语法详解

表格 (Tables)

使用 | 和 - 创建表格,可以使用 : 控制对齐方式(左对齐、居中、右对齐)。

Markdown 写法
| 姓名 | 年龄 | 职业 | | :--- | :---: | ---: | | 张三 | 25 | 工程师 | | 李四 | 30 | 设计师 |
渲染效果预览
姓名 年龄 职业
张三 25 工程师
李四 30 设计师
任务列表

使用 [ ] 和 [x] 创建待办事项列表。

Markdown 写法
- [x] 已完成任务 - [ ] 未完成任务 - [ ] 待处理事项
渲染效果预览
  • ✅ 已完成任务
  • ⬜ 未完成任务
  • ⬜ 待处理事项
脚注

添加引用注释,在文末显示详细说明。

Markdown 写法
这是一段文字[^1]。 [^1]: 这是脚注的内容。
渲染效果预览
这是一段文字[1]
1. 这是脚注的内容。
表情符号

使用 :emoji_name: 语法插入表情符号(GitHub 支持)。

Markdown 写法
:smile: :heart: :rocket: :tada: :fire: :bulb:
渲染效果预览
😄 ❤️ 🚀
🎉 🔥 💡
高亮文本

使用 == 标记高亮文本(部分编辑器支持)。

Markdown 写法
这是 ==高亮文本== 的示例。
渲染效果预览
这是 高亮文本 的示例。

🛠️ 工具推荐

🌐 在线编辑器
  • Dillinger - 在线 Markdown 编辑器
  • StackEdit - 功能丰富的在线工具
  • HackMD - 协作编辑平台
  • Markdown Live Preview - 轻量级预览
💻 桌面应用
  • Typora - 所见即所得编辑器
  • VS Code - 配合插件使用
  • Obsidian - 知识管理工具
  • Notion - 支持 Markdown 语法
  • Mark Text - 开源免费编辑器
⌨️ 快捷键提示(VS Code)
Ctrl/Cmd + B - 加粗
Ctrl/Cmd + I - 斜体
Ctrl/Cmd + Shift + V - 预览
Ctrl/Cmd + K V - 侧边预览
Alt + Shift + F - 格式化
Ctrl/Cmd + / - 注释

🎯 总结与建议

Markdown 是程序员和写作者的必备技能。它让你专注于内容本身,而不是繁琐的排版。

💡 学习建议
  • 1️⃣ 多加练习:在 GitHub README、博客或笔记软件中尝试使用
  • 2️⃣ 选择合适工具:使用 VS Code 或 Typora 等实时预览编辑器
  • 3️⃣ 掌握基础:先熟练基础语法,再学习进阶功能
  • 4️⃣ 保持简洁:Markdown 的美在于简洁,避免过度复杂化
  • 5️⃣ 参考文档:随时查阅 Markdown 语法指南和示例

Copyright© 2026 GptKong.com. All Rights Reserved.