Markdown on September的个人空间

Markdown 基本语法指北

Mon, 06 Apr 2026 00:00:00 +0000

几乎所有现代的博客平台和静态网站生成器都完美支持 Markdown。它能让我们在纯文本环境下专注于内容创作，而无需被复杂的排版工具打断思路。

以下是日常写作中最常用的 Markdown 基本语法。

1. 标题 (Headings)

要在文档中创建标题，请在单词或短语前面添加井号 (#)。# 的数量代表了标题的级别。为了兼容性，请务必在 # 和标题文字之间保留一个空格。

1
2
3
4
5
6


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

2. 段落与换行 (Paragraphs & Line Breaks)

段落： 创建段落非常简单，只需要使用一或多个空白行将连续的文本分隔开即可。不要用空格（spaces）或制表符（tabs）缩进段落。

换行： 如果你想在段落内强行换行（创建 <br>），请在这一行的末尾添加两个或多个空格，然后按回车键。

3. 强调语法 (Emphasis)

通过添加星号或下划线，可以轻松实现加粗和斜体效果。

加粗：在单词或短语的前后各添加两个星号或下划线。
- **加粗文本**
- __加粗文本__
斜体：在单词或短语的前后各添加一个星号或下划线。
- *斜体文本*
- _斜体文本_
加粗斜体：前后各添加三个星号或下划线。
- ***加粗且斜体的文本***

4. 引用 (Blockquotes)

要在段落前添加块引用，请在段落的第一行或者每一行前面添加一个 > 符号。引用不仅支持多段落，还可以嵌套其他 Markdown 元素。

1
2
3
4


> 这是一段引用文本。
> 
> > 这是一个嵌套的引用。
> > 里面还可以使用 **加粗** 等其他语法。

5. 列表 (Lists)

你可以将项目组织成有序列表或无序列表。

有序列表： 在每个列表项前添加数字并紧跟一个英文句点。数字不必按数学顺序排列，但列表应当以数字 1 起始。

1
2
3


1. 第一项
2. 第二项
3. 第三项

无序列表： 在每个列表项前添加破折号 (-)、星号 (*) 或加号 (+)。建议统一使用 -。

1
2
3


- 苹果
- 橘子
- 香蕉

6. 代码 (Code)

行内代码： 如果要把句子中的某个单词或短语标记为代码，请将其包裹在反引号 ( \ `) 中。

示例：使用 print("Hello World") 来输出文本。

代码块： 要创建多行代码块，请将代码包裹在三个反引号 (```) 中。在第一排的反引号后面加上编程语言的名称，就可以实现代码高亮。

1
2


def greet(name):
 print(f"Hello, {name}!")

7. 分隔线 (Horizontal Rules)

要创建一条水平分隔线，请在单独一行上使用三个或多个星号 (***)、破折号 (---) 或下划线 (___)，并且不能包含其他内容。

1

---

8. 链接 (Links)

链接文本放在中括号内，链接地址放在后面的括号内。

语法： [超链接显示名](超链接地址 "可选的提示标题")
示例： 欢迎访问我的 GitHub

如果想直接显示网址并使其可点击，可以用尖括号将网址括起来：<https://example.com>。

示例： https://blog.september.win/

9. 图片 (Images)

插入图片的语法和链接非常相似，只是前面多了一个感叹号 (!)。

语法： ![图片替代文字](图片链接地址 "可选的图片标题")
示例：

1

![美丽的风景图](https://markdown.com.cn/assets/img/philly-magic-garden.9c0b4415.jpg "Magic Gardens")

10. 转义字符 (Escaping Characters)

如果你需要显示原本用于格式化 Markdown 文档的字符（比如你不希望 # 变成标题），可以在该字符前面添加反斜杠 (\) 来转义。

1

\* 这不是一个无序列表项，而是一个普通的星号。

掌握了以上基本语法，你就已经具备了使用 Markdown 撰写结构清晰、排版优雅的博客文章的能力。

Markdown 拓展语法指北

Mon, 06 Apr 2026 00:00:00 +0000

掌握了基本语法后，Markdown 的扩展语法将为你打开新世界的大门。Markdown 官方标准（Basic Syntax）仅包含基础元素，但在实际应用中，许多解析器（如 GitHub Flavored Markdown, Hugo 等）支持更强大的扩展语法。掌握这些进阶技能，能让你轻松处理表格、代码高亮和任务清单。

1. 表格 (Tables)

要在 Markdown 中创建表格，请使用管道符 | 分隔各列，并使用三个或多个连字符 --- 创建表头和内容的分隔线。

对齐方式

通过在分隔线行添加冒号 :，可以控制列的对齐方式：

:---：左对齐（默认）
---:：右对齐
:---:：居中对齐

1
2
3
4


| 语法 | 说明 | 示例 |
| :--- | :---: | ---: |
| 表格 | 居中 | $10 |
| 扩展 | 左对齐 | $20 |

2. 围栏代码块 (Fenced Code Blocks)

扩展语法允许你使用三个反引号（```）或三个波浪号（~~~）来包裹多行代码。最强大的功能是支持语法高亮，只需在开头反引号后指定语言名称（如 python, html, css 等）。

1
2
3
4


{
 "project": "September's Blog",
 "status": "Learning Markdown"
}

3. 脚注 (Footnotes)

脚注用于对正文中的内容添加补充说明，而不会打断读者的阅读流。

用法：在词汇后面使用 [^1]，然后在文档底部定义说明。
示例：这是一个使用了脚注的句子。¹

4. 标题 ID (Heading IDs)

部分解析器支持给标题指定唯一的 ID，方便在文章内部进行跳转（锚点链接）。

1

### 我的目标 {#goals}

5. 定义列表 (Definition Lists)

定义列表允许你列出术语及其对应的定义。

1
2
3
4
5
6


第一项
: 这是第一项的定义。

第二项
: 这是第二项的定义。
: 这是第二项的另一个定义。

6. 删除线 (Strikethrough)

在文字前后各添加两个波浪号 ~~ 来表示已被删除或错误的信息。

示例：~~这件衣服原价 99 元~~，现在只需 19 元。

7. 任务列表 (Task Lists)

任务列表非常适合管理待办事项或项目进度。使用带有空格或 x 的中括号 [ ]。

1
2
3


- [x] 完成基础语法学习
- [x] 掌握扩展语法
- [ ] 发布第一篇技术博客

8. 使用 Emoji 表情

在 Markdown 中添加表情有两种常见方式：

直接从表情库复制并粘贴 Emoji 符号（如 🚀）。
使用“短代码”（需解析器支持），例如输入 :smile: 会被渲染成 😄。

9. 自动网址链接 (Automatic URL Linking)

许多现代解析器会自动将纯文本形式的 URL（如 https://google.com）直接转换为可点击的超链接，而无需额外添加中括号。

通过灵活运用这些扩展语法，你的 Markdown 文档将不仅仅是文字，更是一个具备专业排版水准的数字化作品。

这些扩展语法能显著提升你博客内容的专业度和丰富度。建议在使用前，先确认你所使用的博客主题或编辑器是否已完整开启这些功能支持。

这是在文档末尾自动生成的补充说明。 ↩︎