> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akria.net/llms.txt
> Use this file to discover all available pages before exploring further.
# 第一天|基础语法入门
> 掌握标题、段落、列表、强调和代码的基础写法
**今日目标**：学会 Markdown 最常用的 5 种语法——标题、段落、列表、文本强调和代码。这是所有 Markdown 文档的基础，必须熟练掌握。
## 学习内容 (30 mins)
在开始写之前，先理解这些核心概念。
**Markdown 是什么？**
Markdown 是一种**轻量级标记语言**，用简单的符号就能写出格式化的文档。
**为什么学 Markdown？**
* **简单易学**：语法直观，5 分钟就能上手
* **通用性强**：GitHub、Notion、语雀、飞书都支持
* **专注内容**：不用关心格式，专注于写作
* **版本控制**：纯文本，可以用 Git 管理
**对比传统方式**：
| 方式 | 优点 | 缺点 |
| -------- | ------ | --------- |
| Word | 所见即所得 | 格式复杂，协作困难 |
| Markdown | 简单、易协作 | 需要预览才能看效果 |
**标题的作用**
标题用来组织文档结构，就像书的目录一样。
**语法规则**：
* `#` 表示一级标题（最大）
* `##` 表示二级标题
* `###` 表示三级标题
* 最多支持 6 级标题（`######`）
**示例**：
```markdown theme={null}
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
```
**注意事项**：
* `#` 后面必须有一个空格
* 标题前后会自动空行
* 一级标题通常用于文档标题，二级标题用于章节
**段落**
段落就是普通的文本，直接写就行。
**换行规则**：
* **单换行**：在行末加两个空格，然后回车
* **新段落**：空一行（两个回车）
**示例**：
```markdown theme={null}
这是第一段。
这是第二段。
这是第三段的第一行。
这是第三段的第二行（注意行末有两个空格）。
```
**常见错误**：
❌ 只按一次回车，不会换行（会被合并成一段）\
✅ 空一行才是新段落
**两种列表**
* **无序列表**：用 `-`、`*` 或 `+` 开头
* **有序列表**：用数字加 `.` 开头
**无序列表示例**：
```markdown theme={null}
- 苹果
- 香蕉
- 橙子
或者用 *：
* 苹果
* 香蕉
* 橙子
```
**有序列表示例**：
```markdown theme={null}
1. 第一步
2. 第二步
3. 第三步
```
**嵌套列表**：
```markdown theme={null}
- 水果
- 苹果
- 香蕉
- 蔬菜
- 白菜
- 萝卜
```
**注意事项**：
* 列表项前要有空格（通常是 2 个）
* 嵌套列表要缩进（通常是 4 个空格）
* 有序列表的数字可以乱写（会自动排序）
**强调方式**
* **粗体**：用 `**文本**` 或 `__文本__`
* **斜体**：用 `*文本*` 或 `_文本_`
* **删除线**：用 `~~文本~~`
**示例**：
```markdown theme={null}
这是**粗体**文字
这是*斜体*文字
这是~~删除线~~文字
这是***粗斜体***文字
```
**注意事项**：
* `*` 和 `_` 都可以，但建议统一用一种
* 推荐用 `**` 表示粗体，`*` 表示斜体
***
## 实践任务 (60 mins)
用 Markdown 写一份个人简介，包含以下内容：
* 一级标题：你的名字
* 二级标题：基本信息、工作经历、技能特长
* 使用无序列表列出技能
* 用粗体突出重要信息
**源代码**：
```markdown 示例模板 theme={null}
# 张三
## 基本信息
- **姓名**：张三
- **职位**：产品经理
- **邮箱**：zhangsan@example.com
## 工作经历
1. 2020-2022：XX 公司 - 产品助理
2. 2022-至今：XX 公司 - 产品经理
## 技能特长
- 产品设计
- 项目管理
- 数据分析
```
**渲染效果预览**：
在 Mintlify 中，下面的 Markdown 会被自动渲染成格式化文档：
# 张三
## 基本信息
* **姓名**：张三
* **职位**：产品经理
* **邮箱**：[zhangsan@example.com](mailto:zhangsan@example.com)
## 工作经历
1. 2020-2022：XX 公司 - 产品助理
2. 2022-至今：XX 公司 - 产品经理
## 技能特长
* 产品设计
* 项目管理
* 数据分析
**验证步骤**：
1. 在 [Dillinger](https://dillinger.io/) 中打开
2. 左侧写 Markdown，右侧看预览
3. 检查标题层级是否正确
4. 检查列表格式是否美观
学习如何在文档中插入代码。
**行内代码**：
用反引号 `` ` `` 包裹代码，用于在段落中引用变量名、函数名等。
```markdown theme={null}
使用 `git commit` 命令提交代码。
变量名是 `userName`。
```
**代码块**：
用三个反引号包裹多行代码，可以指定语言。
````markdown 语法 theme={null}
```python
def hello():
print("Hello, Markdown!")
````
````
```python 效果
def hello():
print("Hello, Markdown!")
````
**常用语言标识**：
* `python`、`javascript`、`java`、`bash`、`sql`、`json`、`yaml`
**实践任务**：
在你的个人简介中添加一个"代码示例"部分，展示你熟悉的编程语言。
分隔线用于区分文档的不同部分。
**语法**：
```markdown theme={null}
---
或者
***
或者
___
```
**效果**：都会显示为一条横线
***
**实践任务**：
在你的个人简介中，用分隔线区分不同的章节。
***
## 今日作业 (30 mins)
**要求**：
1. 使用今天学的所有语法：
* 至少 3 级标题
* 有序列表和无序列表
* 粗体和斜体
* 行内代码和代码块
* 分隔线
2. 内容要求：
* 个人信息
* 工作/学习经历
* 技能清单
* 项目经验（如果有）
3. 提交方式：
* 保存为 `day-01-个人简介.md`
* 在 [Dillinger](https://dillinger.io/) 中预览效果
* 截图或导出 PDF 提交
**评分标准**：
* ✅ 语法正确（40 分）
* ✅ 结构清晰（30 分）
* ✅ 内容完整（30 分）
**优秀标准**（加分项）：
* ⭐ 格式美观，排版整齐
* ⭐ 内容有创意，表达清晰
* ⭐ 使用了所有学过的语法
**基础模板**：
```markdown theme={null}
# 你的名字
## 基本信息
- **姓名**：XXX
- **职位**：XXX
- **邮箱**：xxx@example.com
## 工作经历
1. 时间：公司 - 职位
2. 时间：公司 - 职位
## 技能特长
- 技能 1
- 技能 2
- 技能 3
```
***
## 今日产出物
* `day-01-个人简介.md` - 你的第一份 Markdown 文档
* 掌握 5 种基础语法：标题、段落、列表、强调、代码
***
## 参考资源
在 GitHub 查看完整示例
包含个人简介模板
使用 Dillinger 实时预览
无需安装，打开即用
***
## 常见问题
A: 可以，但最多 6 个。`#` 越多，标题越小。建议文档结构不要超过 4 级。
A: 不需要。Markdown 会自动排序，你写 `3.`、`1.`、`2.` 也会显示为 1、2、3。
A: 可以。用 `***文本***` 或 `___文本___` 表示粗斜体。
***
查看完整培训计划
Day 2 | 表格、链接与图片