# 📘 Markdown 完全指南
> 10分钟掌握所有核心语法 · 通用所有平台
> 支持 GitHub/知乎/Notion/VSCode/语雀等
---
## 🧱 基础语法
### 1. 标题
```markdown
# 一级标题 (H1)
## 二级标题 (H2)
### 三级标题 (H3)
#### 四级标题 (H4)
2. 文字样式
**粗体文本**
*斜体文本*
~~删除线文本~~
==高亮文本== (部分平台)
`行内代码`
3. 列表
- 无序列表 (使用 - 或 *)
- 子列表 (缩进2空格)
1. 有序列表
2. 自动编号
4. 链接与图片
[显示文本](https://链接地址)

<https://自动识别链接>
⚙️ 高级功能
5. 代码块
```语言名称
# 支持语法高亮
print("Hello Markdown")
```
6. 表格
| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 单元格 | 单元格 | 单元格 |
| **粗** | *斜* | ~~删~~ |
7. 引用与注释
> 引用文本
>> 嵌套引用
<!-- 这是HTML注释 -->
8. 任务列表
- [x] 已完成
- [ ] 未完成
🎨 扩展功能
9. 数学公式 (需平台支持)
$$ E = mc^2 $$
10. 流程图
graph TD
A[开始] --> B{判断}
B -->|是| C[执行]
B -->|否| D[结束]
11. 目录生成
[TOC] <!-- 自动生成目录 -->
📋 速查表
功能 | 语法 | 效果示例 |
---|---|---|
粗体 | **文本** |
文本 |
斜体 | *文本* |
文本 |
链接 | [标题](URL) |
示例 |
图片 |  |
显示图片 |
代码块 | ```lang<br>代码``` | 语法高亮区 |
表格头 | --- |
列分隔线 |
引用 | > 文本 |
> 引用文本 |
任务列表 | - [ ] 任务 |
- [ ] 任务 |
🚀 最佳实践
-
多级标题构建文档结构
# 主标题 ## 章节 ### 小节
-
列表+任务管理内容
- [x] 完成基础语法 - [ ] 学习高级功能 - [ ] 表格制作 - [ ] 流程图
-
代码块+注释展示技术内容
<!-- 递归实现 -->```python # 计算阶乘 def factorial(n): return 1 if n == 0 else n * factorial(n-1)
-
表格+图标增强可读性
| 状态 | 操作 | |------|------------| | ✅ | 已完成 | | ⚠️ | 需要注意 | | ❌ | 已取消 |
💡 实时练习区
尝试创建以下内容:
- 二级标题:
## 练习标题
- 带粗体的有序列表:
- 第一项
- 第二项
- 插入链接:Markdown官网
- 创建简单表格:
姓名 年龄 张三 28 李四 32
✅ 提示:复制本完整文档到 Typora/VSCode/Notion 等编辑器查看实时渲染效果
---
## 🌐 平台兼容说明
| 平台 | 特色支持 | 备注 |
|------------|------------------------|--------------------------|
| **GitHub** | 任务列表、表格 | README.md 标准 |
| **Notion** | 所有扩展语法 | 支持Mermaid流程图 |
| **知乎** | 基础语法 | 部分CSS样式不同 |
| **语雀** | 数学公式、目录生成 | 企业级文档平台 |
| **Typora** | 实时预览、所有扩展语法 | 最佳本地编辑器 (推荐使用) |
> ⚠️ 注意:不同平台可能对高级语法支持不同,建议先在目标平台测试
使用说明:
- 完整复制:选中从
# 📘 Markdown 完全指南
开始到最后一个反引号的所有内容 - 保存文件:粘贴到文本编辑器,保存为
markdown-guide.md
- 查看效果:
- 直接使用:文档中的示例代码块可直接复制到您的 Markdown 文件中使用
这个完整教程包含:
- 所有核心语法(标题/列表/代码/表格等)
- 可视化速查表
- 平台兼容性指南
- 实时练习区
- 最佳实践示例
设计为开箱即用,无需任何修改即可作为学习资料或参考手册 🚀