1. 什么是 Markdown

Markdown 是一种轻量级的标记语言，用简单的符号（#、**、- 等）表示标题、加粗、列表、链接等，被广泛用于文档写作、博客、README 与需求说明。

2. 基础语法

# 一级标题 ## 二级标题 **加粗** *斜体* `行内代码` - 无序列表项 1. 有序列表项 [链接文字](https://example.com) ![图片](image.png) > 引用文字 ```python # 代码块 print("hello")

```

3. 推荐编辑器

工具	说明
Typora	所见即所得，中文用户友好，本地优先
VS Code	搭配 Markdown All in One / Markdown Preview Enhanced 插件
Obsidian	笔记 + 双向链接，适合知识管理

Typora 使用详解：https://sspai.com/post/54912

4. VS Code 常用 Markdown 插件

• Markdown All in One：快捷键、目录生成、自动格式化等。 https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one
• Markdown Preview Enhanced：增强预览，支持导出 HTML/PDF。
• Markdown PDF：将 Markdown 直接导出为 PDF。

5. 参考教程

• 菜鸟教程（Markdown 进阶）：https://www.runoob.com/markdown/md-advance.html
• YAML front matter 使用可参考本站其他文档。

6. 相关

锚点跳转与序列图等进阶技巧见《Markdown 进阶技巧》：/docs/markdown/tips/。