Markdown 使用手册

简介

Markdown 是一种轻量级标记语言，专注于内容的可读性和易写性。它通过简单符号（如 #、*、>）实现格式控制，可快速转换为 HTML 或其他格式。

优点：

• 纯文本兼容性
• 无需复杂编辑器
• 广泛支持（GitHub、文档工具、博客平台等）

基本语法

一、标题

使用 # 表示标题级别（1-6级）：

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

二、段落与换行

• 段落：直接输入文本，段落间用空行分隔。
• 换行：行尾添加两个空格或使用 <br> 标签。

三、列表

无序列表：使用 *、- 或 +：

- 项目1
- 项目2
  - 子项目（缩进2空格）

有序列表：使用数字加 .：

1. 第一项
2. 第二项
   1. 子项

四、强调文本

• 粗体：**粗体** 或 __粗体__
• 斜体：*斜体* 或 _斜体_
• 粗斜体：***粗斜体***

五、链接与图片

• 链接：[显示文本](URL "可选标题")

  [Google](https://www.google.com)

• 图片：![替代文本](图片路径/URL)

  ![Logo](logo.png "标题")

六、代码块

• 行内代码：用反引号包裹 code

• 多行代码：用三个反引号（可指定语言）：

  ```python
  print("Hello World")
  ```

七、表格

使用 | 分隔列，- 分隔表头：

| 左对齐 | 居中对齐 | 右对齐 |
| :----- | :------: | -----: |
| 内容1  |   内容2  |   内容3 |

八、引用块

使用 > 表示引用：

> 这是引用内容
> 多行引用

九、分隔线

三个及以上 *、- 或 _：

---
***
___

高级语法

一、删除线

用双波浪线包裹：~~删除线~~ → 删除线

二、任务列表

使用 - [ ] 或 - [x]：

- [ ] 未完成任务
- [x] 已完成任务

三、Emoji

直接输入符号或使用代码 :emoji_name:：

😊 :smile: :thumbsup:

四、自动目录

部分解析器支持 [TOC] 自动生成目录（非标准语法）。

五、脚注

使用 [^标签] 和底部定义：

这是一个脚注示例[^1]。

[^1]: 脚注的详细说明。

六、数学公式

使用 $$ 包裹 LaTeX 公式（需支持扩展）：

$$
E = mc^2
$$

七、流程图与图表

需支持 Mermaid 等扩展语法：

```mermaid
graph TD
  A[开始] --> B{条件}
  B -->|是| C[执行]
  B -->|否| D[结束]
```

工具推荐

• 编辑器：VS Code、Typora、Obsidian
• 在线工具：StackEdit、Dillinger
• 预览工具：浏览器插件、Markdown Preview

注意事项

1. 特殊符号（如 *、#）需用反斜杠转义：\*
2. 不同平台可能支持不同的扩展语法
3. 表格和复杂格式建议使用工具生成
4. 图片路径需确保正确性（绝对/相对路径）