Appearance
Markdown语法
基础语法
标题
使用 # 符号,数量代表级别(1-6级)。
markdown
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题注: # 和文字之间建议保留一个空格。
段落与换行
- 段落:直接连续书写,空一行表示分段。
- 换行:行末敲 两个空格 再回车;或者直接使用
<br>标签。
markdown
这是第一段。
(此处空一行)
这是第二段。
这是第一行(末尾两个空格)
这是第二行(软换行)强调(字体样式)
| 效果 | 语法 | 示例 |
|---|---|---|
| 加粗 | **文字** 或 __文字__ | 加粗 |
| 斜体 | *文字* 或 _文字_ | 斜体 |
| 加粗斜体 | ***文字*** | 加粗斜体 |
~~文字~~ | ||
| 下划线 | <u>文字</u>(HTML标签) | 下划线 |
列表
无序列表(使用 - * +)
markdown
- 项目1
- 项目2
- 子项目2.1(缩进2或4空格)
- 子项目2.2有序列表(数字 + 点)
markdown
1. 第一步
2. 第二步
3. 子步骤2.1(缩进3空格)
4. 子步骤2.2技巧: 数字不必真实,Markdown 会自动排序,但建议按实际写。
任务列表(待办事项)
markdown
- [x] 已完成任务
- [ ] 未完成任务
- [ ] 子任务(缩进)链接与图片
链接
markdown
[显示文字](https://example.com "悬停标题(可选)")图片(比链接多一个 !)
markdown
引用式链接(高级用法,便于复用)
markdown
[显示文字][引用ID]
[引用ID]: https://example.com "说明"引用(Blockquote)
使用 > 符号,可嵌套。
markdown
> 这是一级引用。
> > 这是二级引用(嵌套)。
> 回到一级。代码
行内代码(使用反引号 `)
markdown
请使用 `print("Hello")` 函数输出。代码块(使用三个反引号 ``` 或缩进4空格)
markdown
```python
def hello():
print("Hello, World!")
```指定语言(第一个反引号后跟语言名)可实现语法高亮(需渲染器支持)。
进阶语法
分割线
使用三个或以上的 - * _(需独占一行)。
markdown
---
***
___表格
语法要点:
- 表头与内容用
|---|分隔(:控制对齐方向)。 - 列数需一致。
markdown
| 左对齐(默认) | 居中对齐 | 右对齐 |
| :--- | :---: | ---: |
| 单元格1 | 单元格2 | 单元格3 |
| 单元格4 | 单元格5 | 单元格6 |转义字符
使用反斜杠 \ 转义 Markdown 特殊符号。
markdown
\* 这不是斜体 \*
\# 这不是标题HTML 标签(补充能力)
Markdown 支持内联 HTML(在大多数平台),可用于实现原生语法不支持的效果:
html
<!-- 换行 -->
<br>
<!-- 居中(部分平台支持) -->
<center>居中文字</center>
<!-- 字体颜色(部分平台支持) -->
<font color="red">红色文字</font>
<!-- 键盘按键 -->
<kbd>Ctrl</kbd> + <kbd>C</kbd>扩展语法
GFM(GitHub Flavored Markdown) 是 GitHub 的扩展标准,多数现代编辑器支持。
自动链接
直接写 URL(带协议),会自动变成可点击链接。
markdown
https://www.example.com
<user@example.com> <!-- 邮箱自动链接 -->脚注(Footnote)
markdown
这是带脚注的文字[^1]。
[^1]: 这里是脚注内容。删除线(已在基础部分提及,但 GFM 标准)
~~删除文字~~
表情符号(Emoji)
- 直接复制粘贴 😊。
- 或使用短代码(如
:smile:),需平台支持(GitHub 支持)。
高亮(Highlight)
非标准,部分编辑器支持:
markdown
==高亮文字==上标与下标(使用 HTML 或 LaTeX)
markdown
H<sub>2</sub>O <!-- 下标 -->
x<sup>2</sup> <!-- 上标 -->数学公式(LaTeX,需渲染器支持如 MathJax)
markdown
行内公式:$E = mc^2$
公式块:
$$
\int_{0}^{\infty} e^{-x^2} dx = \frac{\sqrt{\pi}}{2}
$$常用写作技巧与最佳实践
保持空行规范
- 标题、列表、代码块、表格前后各空一行(增强可读性)。
统一符号风格
- 列表统一用
-(或*),不要混用。
图片尺寸控制(使用 HTML)
html
<img src="image.jpg" width="300" alt="描述">锚点跳转(页面内跳转)
- 标题会自动生成 id(一般规则:小写、空格转连字符)。
markdown
[跳转到基础部分](#第一部分基础语法-80-日常使用)渲染差异说明
| 平台/工具 | 差异点 |
|---|---|
| GitHub | 支持 GFM、任务列表、emoji短码 |
| Typora/Obsidian | 支持高亮、数学公式、图表 |
| 知乎/微信公众号 | 支持有限,多数需用在线编辑器转换 |
| Notion | 部分语法不同(如 / 命令替代部分原生) |
速查卡片
markdown
# 标题
**加粗** *斜体* ~~删除线~~
- 无序列表
1. 有序列表
- [ ] 任务列表
[链接](url) 
> 引用
`行内代码`
```代码块```
| 表格 | 表格 |
|------|------|
| 内容 | 内容 |
--- 分割线