用一个 skill.md 学会 Markdown：AI 时代的小白写作格式

Markdown 是 AI 时代的 Word，很多人却以为这是程序员才需要的东西。

如果你完全没学过技术，第一次看到 .md 文件，可能会有点紧张：这是不是代码？是不是要装什么软件？是不是程序员才看得懂？

不用想复杂。

你可以先把 Markdown 理解成一种“结构很清楚的写作格式”。

它不是为了让文字变复杂，而是为了让结构变清楚。

以前我们写文档，很习惯用 Word。Word 的优势是排版，字体、字号、颜色、居中、打印效果，都可以调得很正式。

但 AI 时代，多了一个新问题：你的文字不只是给人看的，也经常要给 AI 看。

你让 AI 写文章、改提示词、总结资料、生成脚本、执行任务，它都需要先看懂你的意思。它要知道哪一句是主题，哪一句是背景，哪一句是任务，哪一句是要求，哪一句是输出格式。

如果所有内容都挤成一大段，人看着累，AI 也要猜。

比如你把一整段要求直接丢给 AI：

“帮我写一篇文章，要适合小白，要自然一点，要有标题，要有结尾，还要适合公众号。”

AI 当然也能写，但它要自己判断哪些是任务，哪些是风格，哪些是输出要求。

如果你用标题、列表和输出格式拆开，它就不用猜那么多。

Markdown 解决的就是这个问题。

Word 更重排版，Markdown 更重结构。

Word 更像最终稿，Markdown 更像内容底稿。

Word 让文档更正式，Markdown 让内容更容易被理解和复用。

所以你不需要把 Markdown 当成一门复杂技术。小白先学最常用的几个符号，就已经够用了。

这篇文章不讲 Markdown 历史，不讲工具安装，也不讲完整语法大全。

我们只用一个 skill.md 例子，带你看懂 Markdown 最常用的写法。

你可以把 skill.md 理解成一份写给 AI 的技能说明书。它告诉 AI：你是谁，你要做什么，你按什么步骤做，最后输出成什么样。

Markdown 更像是写给人和 AI 同时看的说明书格式。

1. 先看懂一个 skill.md

先看完整例子。你不用急着背语法，只要先感受它的结构。

如果第一眼觉得这段有点长，也没关系。

你先只看小标题和列表：它是不是在告诉 AI 角色、目标、任务、流程和输出格式？

后面我们会一行一行拆。

# 文章写作助手 Skill

## 角色

你是一名 **适合小白读者** 的内容编辑，擅长把复杂内容改写成清楚、自然、容易理解的文章。

## 核心目标

请帮助用户把一个想法扩展成一篇 **结构清楚、语言自然、适合发布** 的文章。

## 你需要完成的任务

- 理解用户给出的主题
- 拆解文章的大纲
- 优化文章标题
- 扩写正文内容
- 提炼结尾观点

## 工作流程

1. 先判断用户想表达的核心观点
2. 再生成文章结构
3. 然后逐段扩写正文
4. 最后检查语言是否自然

## 写作原则

> 好文章不是堆信息，而是帮读者把一件事想明白。

## 输出格式

请按照下面格式输出：

~~~md
# 文章标题

## 开头

这里写文章开头。

## 正文

这里写正文内容。

## 总结

这里写总结。
~~~

## 参考资料

如果用户需要学习 Markdown，可以参考：[Markdown 基础说明](https://example.com)

## 使用前检查

- [ ] 是否已经说明文章主题
- [ ] 是否已经说明目标读者
- [ ] 是否已经说明文章风格
- [ ] 是否已经说明输出格式

这份文件本质上不是代码。

它更像一份写给 AI 的说明书。

它告诉 AI：

• 你是谁
• 你要做什么
• 你要按照什么步骤做
• 你要遵守什么原则
• 你最后按照什么格式输出
• 使用前要检查什么

你虽然还没正式学 Markdown，但大概率已经能看懂这份文件的大概意思。

这就是 Markdown 的好处：它不复杂，但结构很清楚。

标题一分，任务一列，步骤一排，重点一标，整份说明书马上变得很容易读。

AI 读这种文件，也更容易理解你的要求。

下面我们就只围绕这个例子，学 8 类最常用的 Markdown 写法。

2. 从这个 skill.md 里学 8 类常用写法

小白不用一开始学完整 Markdown。

先记住这 8 类就够了：标题、加粗、无序列表、编号列表、引用、链接、代码块、任务列表。

2.1 标题：一份文档的名字和章节

它在案例里这样出现：

# 文章写作助手 Skill

## 角色

## 核心目标

## 你需要完成的任务

## 工作流程

标题这一类先记两个写法就够了：一个 # 是整份文档的大标题，两个 ## 是文档里的小章节。

你可以把它理解成 Word 里的“文章标题”和“章节标题”。

在这个 skill.md 里，# 文章写作助手 Skill 是整份文件的名字。它告诉人和 AI：这是一份文章写作助手的技能说明。

下面这些 ##，则是把说明书分成几个部分：

• ## 角色 说明 AI 要扮演谁
• ## 核心目标 说明 AI 要完成什么
• ## 你需要完成的任务 说明 AI 要做哪些事
• ## 工作流程 说明 AI 先做什么、再做什么

小白什么时候会用到？

当你写一篇文章、一份提示词、一份说明书，或者一个简单的 skill.md，都可以先用标题把结构分出来。

写的时候注意两件事。

第一，一份简单文档通常一个 # 大标题就够了。

第二，文档内部的小部分用 ##，不要把所有标题都写成 #。

标题层级越清楚，AI 越容易理解你的结构。

如果你要写一个自己的 AI 助手，最简单的办法就是先列几个小章节标题：

## 角色

## 任务

## 要求

## 输出格式

先把框架搭出来，再往里面填内容。

2.2 加粗：突出重点

它在案例里这样出现：

**适合小白读者**

还有这一句：

**结构清楚、语言自然、适合发布**

两边各两个星号，表示加粗。

加粗的作用不是让文字看起来花哨，而是提醒读者和 AI：这里是重点。

比如 **适合小白读者** 这几个字，就在提醒 AI：你写出来的内容不能太专业，不能太绕，要让没有基础的人也看得懂。

小白只要记住：加粗适合突出关键词，不适合整段都加粗。

如果整段都加粗，就等于没有重点。

更好的做法是只加粗真正关键的词，比如读者、风格、输出要求。

2.3 无序列表：拆开并列信息

它在案例里这样出现：

- 理解用户给出的主题
- 拆解文章的大纲
- 优化文章标题
- 扩写正文内容
- 提炼结尾观点

每一行前面加一个 -，就是无序列表。

这里的“无序”不是说内容乱，而是说这些事项没有严格先后关系。它们都是 AI 需要完成的任务。

无序列表适合表达多个并列事项。

比如你要告诉 AI 一篇文章需要做到什么，不建议写成一大段：

你要理解主题，拆解大纲，优化标题，扩写正文，还要提炼结尾观点。

这样也能看懂，但不够清楚。

改成列表以后，就更像任务清单：

- 理解用户给出的主题
- 拆解文章的大纲
- 优化文章标题
- 扩写正文内容
- 提炼结尾观点

AI 看到列表，也更容易一条一条执行。

2.4 编号列表：表达步骤

它在案例里这样出现：

1. 先判断用户想表达的核心观点
2. 再生成文章结构
3. 然后逐段扩写正文
4. 最后检查语言是否自然

1. 2. 3. 这种写法，就是编号列表，也可以叫有序列表。

编号列表适合表达有顺序的步骤。

比如这个 skill.md 里的工作流程，不能随便调换顺序。

你要先判断核心观点，再生成文章结构，然后扩写正文，最后检查语言。

这就适合用编号列表。

这里顺便记住无序列表和编号列表的区别：

• 无序列表：几件事没有明显先后，用 -
• 编号列表：几件事有先后步骤，用 1. 2. 3.

如果你只是在列任务，用无序列表。

如果你是在写流程，用编号列表。

这个区别很重要，因为 AI 会根据这种结构判断：这些内容是并列任务，还是执行步骤。

2.5 引用：突出一句重要观点

它在案例里这样出现：

> 好文章不是堆信息，而是帮读者把一件事想明白。

> 表示引用。

你可以把它理解成：把一句重要的话单独拎出来。

在文章里，它像一句金句。

在 skill.md 里，它可以用来强调 AI 要遵守的原则。

比如这句话其实就在提醒 AI：不要只是把资料堆出来，要帮读者把问题讲明白。

小白写自己的 skill.md 时，可以把最重要的原则写成引用。

比如：

> 不要追求复杂，先把读者最关心的问题讲清楚。

引用不要太多。

一份简单说明里，放 1 到 2 句真正重要的话就够了。

2.6 链接：放参考资料

它在案例里这样出现：

[Markdown 基础说明](https://example.com)

方括号 [] 里放显示出来的文字。

小括号 () 里放链接地址。

小白只要记住这个格式：

[显示文字](链接地址)

链接适合放参考资料、官网、教程地址。

在这个 skill.md 里，Markdown 基础说明 是读者看到的文字，https://example.com 是示例链接地址。

这里不需要学更复杂的写法。

你只要知道：想让别人点一段文字跳到某个网页，就用 [文字](地址)。

写的时候注意：正式使用时，把示例地址换成真实地址；不要把方括号和小括号写反。

2.7 代码块：保存模板、提示词和示例

它在案例里这样出现：

请按照下面格式输出：

~~~md
# 文章标题

## 开头

这里写文章开头。

## 正文

这里写正文内容。

## 总结

这里写总结。
~~~

代码块这个名字听起来有点技术，但小白不用怕。

你可以把它理解成：这里有一段内容，需要原样展示，不要被当成普通正文。

小白先记一个最常用写法就行：用三个反引号把内容包起来。

你平时可以这样写：

```md
# 文章标题

## 开头

这里写文章开头。
```

开头三个反引号，结尾三个反引号，中间放模板、提示词或示例。

这个案例里，输出格式部分用了三个波浪线：

~~~md
这里放模板内容
~~~

你现在可以先不用记波浪线。

它的作用和代码块类似，都是为了原样展示一段内容。入门阶段，先记三个反引号就够了。

```md
这里放模板、提示词或示例
```

上面这一小段，你只要看懂意思就行：代码块就是“原样展示区”。

另外，如果你在本文源文件里偶尔看到四个反引号，那只是为了把“三个反引号”本身展示出来。自己写 Markdown 时，先不用管它。

代码块特别适合保存模板、提示词、输出格式和示例。

如果你想让 AI 按某个固定格式输出，最好把格式放进代码块里。

这样 AI 更容易明白：这不是普通说明，而是要照着使用的模板。

2.8 任务列表：做检查清单

它在案例里这样出现：

- [ ] 是否已经说明文章主题
- [ ] 是否已经说明目标读者
- [ ] 是否已经说明文章风格
- [ ] 是否已经说明输出格式

- [ ] 表示一个未完成任务。

它很适合做检查清单。

比如写文章前检查：

• 是否有主题
• 是否有目标读者
• 是否有文章风格
• 是否有输出格式

如果任务完成了，也可以写成：

- [x] 已经说明文章主题

任务列表的价值不在于好看，而是让你不容易漏东西。

对 AI 来说，检查清单也很有用。

你可以在 skill.md 最后放一个“使用前检查”，提醒 AI 在输出前重新核对。

写的时候注意：- 后面要有空格，方括号里面也要留一个空格，完整写法是 - [ ] 任务。

3. 怎么改这个 skill.md，变成自己的 AI 助手？

学 Markdown，不只是为了看懂文件。

更重要的是，你能开始改。

还是用刚才这个 文章写作助手 Skill，不要换例子。

你只需要先改 4 个地方：角色、任务、工作流程、输出格式。

3.1 改角色

原来是：

## 角色

你是一名 **适合小白读者** 的内容编辑，擅长把复杂内容改写成清楚、自然、容易理解的文章。

如果你想让它变成短视频脚本助手，可以改成：

## 角色

你是一名 **短视频脚本策划**，擅长把复杂内容改写成适合口播的短视频脚本。

这里改的是 AI 的身份。

身份越清楚，AI 越知道自己应该用什么角度处理问题。

3.2 改任务

原来是：

## 你需要完成的任务

- 理解用户给出的主题
- 拆解文章的大纲
- 优化文章标题
- 扩写正文内容
- 提炼结尾观点

如果你想让它写短视频脚本，可以改成：

## 你需要完成的任务

- 理解用户给出的主题
- 设计视频开头
- 拆解口播结构
- 写出完整脚本
- 提炼结尾引导语

这里改的是 AI 要做的事。

如果你只改角色，不改任务，AI 可能还是按旧任务工作。

所以角色和任务最好一起改。

3.3 改工作流程

原来是：

## 工作流程

1. 先判断用户想表达的核心观点
2. 再生成文章结构
3. 然后逐段扩写正文
4. 最后检查语言是否自然

可以改成：

## 工作流程

1. 先判断视频要解决的问题
2. 再设计开头钩子
3. 然后生成口播结构
4. 最后检查是否适合直接朗读

这里改的是 AI 做事的顺序。

如果几件事有先后，就用编号列表。

这一步很适合用 Markdown，因为步骤一排出来，AI 就不容易跳步。

3.4 改输出格式

原来是：

## 输出格式

请按照下面格式输出：

~~~md
# 文章标题

## 开头

这里写文章开头。

## 正文

这里写正文内容。

## 总结

这里写总结。
~~~

如果你想让它输出短视频脚本，可以改成：

## 输出格式

请按照下面格式输出：

~~~md
# 视频标题

## 开头

这里写前 10 秒口播。

## 正文

这里写完整口播内容。

## 结尾

这里写结尾引导语。
~~~

输出格式很重要。

很多人用 AI 时，最大的问题不是 AI 不会写，而是你没有告诉它最后要长什么样。

用 Markdown 把输出格式写清楚，AI 就更容易交付你想要的结果。

改完以后，一个短视频脚本助手的简化版可能长这样：

# 短视频脚本助手 Skill

## 角色

你是一名 **短视频脚本策划**，擅长把复杂内容改写成适合口播的短视频脚本。

## 你需要完成的任务

- 理解用户给出的主题
- 设计视频开头
- 拆解口播结构
- 写出完整脚本
- 提炼结尾引导语

## 工作流程

1. 先判断视频要解决的问题
2. 再设计开头钩子
3. 然后生成口播结构
4. 最后检查是否适合直接朗读

## 写作原则

> 好脚本不是堆信息，而是让观众愿意继续听下去。

## 输出格式

请按照“视频标题 / 开头 / 正文 / 结尾”四段输出。

## 使用前检查

- [ ] 是否已经说明视频主题
- [ ] 是否已经说明目标观众
- [ ] 是否已经说明口播风格
- [ ] 是否已经说明输出格式

怎么判断自己有没有改对？

很简单。你把一个主题交给 AI，看它是不是按你写的角色、任务和输出格式来回答。

如果它没有按“四段输出”，就回到 ## 输出格式 里写得更具体一点。

现在你可以试着把这个「文章写作助手 Skill」改成你自己的 AI 助手。

你只需要先改 4 个地方：角色、任务、工作流程、输出格式。

不用一次改得完美。

先能跑起来，比一开始追求复杂更重要。

4. 小白常见错误和改正方法

刚开始写 Markdown，出错很正常。

好消息是：这些错误都不难改。

下面只讲和前面 8 类写法有关的常见问题。

4.1 标题层级乱用

错误写法：

## 文章写作助手 Skill

# 角色

正确写法：

# 文章写作助手 Skill

## 角色

一个 # 是整份文档的名字，两个 ## 是里面的小章节。

不要把它们反过来。

4.2 列表和正文挤在一起

错误写法：

你需要完成的任务- 理解主题- 拆解大纲- 优化标题

正确写法：

你需要完成的任务：

- 理解主题
- 拆解大纲
- 优化标题

列表最好单独换行。

这样人看得清楚，AI 也更容易逐条理解。

4.3 加粗只写了一边

错误写法：

**重点

正确写法：

**重点**

加粗要两边都有两个星号。

只写一边，就像括号没关上。

4.4 编号列表和无序列表混用

错误写法：

- 先判断核心观点
2. 再生成文章结构
- 最后检查语言

正确写法：

1. 先判断核心观点
2. 再生成文章结构
3. 最后检查语言

如果你写的是步骤，就统一用编号列表。

如果你写的是并列任务，就统一用无序列表。

不要一会儿 -，一会儿 1.。

4.5 代码块忘记结尾

错误写法：

```md
# 文章标题

## 开头
这里写开头。

正确写法：

```md
# 文章标题

## 开头
这里写开头。
```

代码块要有开头，也要有结尾。

如果你用三个反引号开始，就要用三个反引号结束。

4.6 任务列表格式写错

错误写法：

-[ ] 写初稿

正确写法：

- [ ] 写初稿

- 后面要有一个空格，[ ] 里面也要保留空格。

完整写法就是：

- [ ] 任务

如果任务完成了，可以写成：

- [x] 已完成的任务

5. 总结：不用学完整 Markdown，先学会够用的

Markdown 不是程序员专属。

它是一种结构化写作方式。

AI 时代，写得清楚比排得漂亮更重要。

你不用一开始学完整 Markdown，也不用背一堆复杂语法。

先记住这几个符号，就已经够用了。

标题用 # 和 ##，**文字** 是加粗，- 是列表，1. 是步骤，> 是引用，[文字](地址) 是链接，代码块放模板，- [ ] 做检查清单。

真正重要的不是符号本身，而是你开始用结构表达想法。

当你能把一段模糊要求，拆成标题、任务、步骤、原则和输出格式，AI 就更容易理解你，也更容易给出稳定结果。

如果你想继续系统练习，我也整理了一份 Markdown 小白文字版资料，里面会把常用模板、skill.md 修改方法和 AI 提示词写法放在一起，你可以直接照着用。

下次你写提示词、写文章大纲、写说明书，或者改一个简单的 skill.md，可以先试这个最小动作：

# 你要做的事

## 背景

这里写背景。

## 任务

- 任务一
- 任务二
- 任务三

## 输出格式

请按照指定格式输出。

先不要追求完整。

先让结构清楚。

今天先写出这个最小结构，就算入门第一步完成。

附录：Markdown 常用语法速查表

用途	写法	示例
标题	# 标题 / ## 标题	# 我的文章 / ## 第一章
加粗	**文字**	**重点**
无序列表	- 内容	- 第一项
编号列表	1. 内容	1. 第一步
引用	> 内容	> 这是观点
链接	[文字](地址)	[官网](https://example.com)
代码块	三个反引号	用来放模板、提示词、示例
任务列表	- [ ] 任务	- [ ] 写初稿