📝 基础语法
本文档介绍纸鸢博客中支持的 Markdown 基础语法特性。
💡 提示：本文档中的所有语法示例均已在纸鸢博客中测试通过，可直接复制使用。
🎯 基础语法
1️⃣ 标题
语法：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题效果：
一级标题
二级标题
三级标题
四级标题
五级标题
六级标题
2️⃣ 段落
语法：
这是一个普通段落。
这是另一个段落，通过空行分隔。效果： 这是一个普通段落。
这是另一个段落，通过空行分隔。
3️⃣ 强调
语法：
*斜体文本*
_斜体文本_
**粗体文本**
__粗体文本__
***粗斜体文本***
___粗斜体文本___效果： 斜体文本 斜体文本 粗体文本 粗体文本 粗斜体文本 粗斜体文本
4️⃣ 列表
无序列表
语法：
- 项目一
- 项目二
- 项目三
- 子项目一
- 子项目二效果：
- 项目一
- 项目二
- 项目三
- 子项目一
- 子项目二
有序列表
语法：
1. 第一项
2. 第二项
3. 第三项
1. 子项1
2. 子项2效果：
- 第一项
- 第二项
- 第三项
- 子项1
- 子项2
5️⃣ 引用
语法：
> 这是一个引用
>
> 引用可以有多行
>
> > 嵌套引用效果：
这是一个引用
引用可以有多行
嵌套引用
6️⃣ 行内代码
语法：
使用 `npm install` 安装依赖
在 JavaScript 中，`const` 用于声明常量效果：
使用 npm install 安装依赖
在 JavaScript 中，const 用于声明常量
7️⃣ 分隔线
语法：
---
***
___效果：
8️⃣ 脚注
语法：
这是一个带有脚注的文本[^1]。
[^1]: 这是脚注的内容效果： 这是一个带有脚注的文本^1。
📚 扩展语法
以下语法有详细的独立文档说明：
| 语法 | 说明 | 文档链接 |
|---|---|---|
| 💻 代码块 | 支持多种编程语言的语法高亮 | 代码块语法示例 |
| 🔗 链接 | 文本链接、图片链接、自动链接等 | 链接语法示例 |
| 🖼️ 图片 | 基础图片、带标题图片、图片链接等 | 图片语法示例 |
| 📊 表格 | 基础表格、对齐方式、高级用法等 | 表格语法示例 |
| ✅ 任务列表 | 任务列表、嵌套任务、进度追踪等 | 任务语法示例 |
🎨 高级语法
1️⃣ 自动链接
语法：
<https://gl.baimu.live/>
<白木 原创开发>效果：
2️⃣ 转义字符
语法：
\* 这不是斜体 \*
\# 这不是标题
\[ 这不是链接的开始 \]效果： * 这不是斜体 * # 这不是标题 [ 这不是链接的开始 ]
3️⃣ 混合使用示例
语法：
### 示例标题
这是一个包含 **粗体** 和 *斜体* 的段落，还有 `行内代码`。
> 引用中的 **强调** 和 `代码`
- 列表项
- 另一个列表项
- 子列表项效果：
示例标题
这是一个包含 粗体 和 斜体 的段落，还有 行内代码。
引用中的 强调 和
代码
- 列表项
- 另一个列表项
- 子列表项
💡 最佳实践
1️⃣ 标题层级
- 一级标题 (
#) 用于文档主标题 - 二级标题 (
##) 用于主要章节 - 三级标题 (
###) 用于子章节 - 避免使用过多层级，建议不超过 4 级
2️⃣ 段落与换行
- 使用空行分隔段落
- 段落内换行使用两个空格 + 回车
3️⃣ 列表使用
- 保持列表项格式一致
- 嵌套列表使用 2 个空格缩进
4️⃣ 强调使用
- 使用
**粗体**突出重要内容 - 使用
*斜体*表示强调或外来语 - 避免过度使用，保持文档可读性
5️⃣ 文档结构
- 使用一致的标题层级
- 添加适当的空白行分隔内容
- 使用列表和引用使内容更结构化
- 为长篇文档添加目录（纸鸢博客会自动生成）
📝 示例文档模板
---
title: 文档标题
description: 文档描述
date: 2026-04-03
tags: 标签1、标签2
cover: /assets/cover-image.jpg
url: /custom-path
---
# 文档标题
## 章节标题
### 子章节标题
这是一个段落，包含 **粗体** 和 *斜体* 文本。
- 列表项1
- 列表项2
- 子列表项
> 这是一个引用示例
使用 `code` 表示行内代码🕊️ 白木 原创开发 🔗 gl.baimu.live