Skip to main content
今日目标：学会 Markdown 最常用的 5 种语法——标题、段落、列表、文本强调和代码。这是所有 Markdown 文档的基础，必须熟练掌握。

​
学习内容 (30 mins)

在开始写之前，先理解这些核心概念。
Markdown 是什么？Markdown 是一种轻量级标记语言，用简单的符号就能写出格式化的文档。为什么学 Markdown？
  • 简单易学：语法直观，5 分钟就能上手
  • 通用性强：GitHub、Notion、语雀、飞书都支持
  • 专注内容：不用关心格式，专注于写作
  • 版本控制：纯文本，可以用 Git 管理
对比传统方式：
方式优点缺点
Word所见即所得格式复杂，协作困难
Markdown简单、易协作需要预览才能看效果
标题的作用标题用来组织文档结构，就像书的目录一样。语法规则：
  • # 表示一级标题（最大）
  • ## 表示二级标题
  • ### 表示三级标题
  • 最多支持 6 级标题（######）
示例：
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题
注意事项：
  • # 后面必须有一个空格
  • 标题前后会自动空行
  • 一级标题通常用于文档标题，二级标题用于章节
段落段落就是普通的文本，直接写就行。换行规则：
  • 单换行：在行末加两个空格，然后回车
  • 新段落：空一行（两个回车）
示例：
这是第一段。

这是第二段。

这是第三段的第一行。  
这是第三段的第二行（注意行末有两个空格）。
常见错误：❌ 只按一次回车，不会换行（会被合并成一段）
✅ 空一行才是新段落
两种列表
  • 无序列表：用 -、* 或 + 开头
  • 有序列表：用数字加 . 开头
无序列表示例：
- 苹果
- 香蕉
- 橙子

或者用 *：
* 苹果
* 香蕉
* 橙子
有序列表示例：
1. 第一步
2. 第二步
3. 第三步
嵌套列表：
- 水果
  - 苹果
  - 香蕉
- 蔬菜
  - 白菜
  - 萝卜
注意事项：
  • 列表项前要有空格（通常是 2 个）
  • 嵌套列表要缩进（通常是 4 个空格）
  • 有序列表的数字可以乱写（会自动排序）
强调方式
  • 粗体：用 **文本** 或 __文本__
  • 斜体：用 *文本* 或 _文本_
  • 删除线：用 ~~文本~~
示例：
这是**粗体**文字
这是*斜体*文字
这是~~删除线~~文字
这是***粗斜体***文字
注意事项：
  • * 和 _ 都可以，但建议统一用一种
  • 推荐用 ** 表示粗体，* 表示斜体

​
实践任务 (60 mins)

1

任务 1: 编写个人简介

用 Markdown 写一份个人简介，包含以下内容：
  • 一级标题：你的名字
  • 二级标题：基本信息、工作经历、技能特长
  • 使用无序列表列出技能
  • 用粗体突出重要信息
源代码：
# 张三

## 基本信息

- **姓名**：张三
- **职位**：产品经理
- **邮箱**：zhangsan@example.com

## 工作经历

1. 2020-2022：XX 公司 - 产品助理
2. 2022-至今：XX 公司 - 产品经理

## 技能特长

- 产品设计
- 项目管理
- 数据分析
渲染效果预览：
在 Mintlify 中，下面的 Markdown 会被自动渲染成格式化文档：

​
张三

​
基本信息

​
工作经历

  1. 2020-2022：XX 公司 - 产品助理
  2. 2022-至今：XX 公司 - 产品经理

​
技能特长

  • 产品设计
  • 项目管理
  • 数据分析
验证步骤：
  1. 在 Dillinger 中打开
  2. 左侧写 Markdown，右侧看预览
  3. 检查标题层级是否正确
  4. 检查列表格式是否美观
2

任务 2: 行内代码与代码块

学习如何在文档中插入代码。行内代码：用反引号 ` 包裹代码，用于在段落中引用变量名、函数名等。
使用 `git commit` 命令提交代码。
变量名是 `userName`。
代码块：用三个反引号包裹多行代码，可以指定语言。
```python
def hello():
    print("Hello, Markdown!")
常用语言标识：
  • python、javascript、java、bash、sql、json、yaml
实践任务：在你的个人简介中添加一个”代码示例”部分，展示你熟悉的编程语言。
3

任务 3: 分隔线

分隔线用于区分文档的不同部分。语法：
---

或者

***

或者

___
效果：都会显示为一条横线
实践任务：在你的个人简介中，用分隔线区分不同的章节。

​
今日作业 (30 mins)

作业：完善个人简介文档

要求：
  1. 使用今天学的所有语法：
    • 至少 3 级标题
    • 有序列表和无序列表
    • 粗体和斜体
    • 行内代码和代码块
    • 分隔线
  2. 内容要求：
    • 个人信息
    • 工作/学习经历
    • 技能清单
    • 项目经验（如果有）
  3. 提交方式：
    • 保存为 day-01-个人简介.md
    • 在 Dillinger 中预览效果
    • 截图或导出 PDF 提交

​
今日产出物

  • day-01-个人简介.md - 你的第一份 Markdown 文档
  • 掌握 5 种基础语法：标题、段落、列表、强调、代码

​
参考资源

查看参考示例

在 GitHub 查看完整示例

在线编辑器

使用 Dillinger 实时预览

​
常见问题

A: 可以，但最多 6 个。# 越多，标题越小。建议文档结构不要超过 4 级。
A: 不需要。Markdown 会自动排序，你写 3.、1.、2. 也会显示为 1、2、3。
A: 可以。用 ***文本*** 或 ___文本___ 表示粗斜体。

回到概览

查看完整培训计划

下一天: 进阶语法

Day 2 | 表格、链接与图片