docs

Markdown 语法速览

2026-05-06
FeelFish Team

Markdown 语法速览

写给小说创作者的 Markdown 快速参考手册。大模型接收和返回文本,Markdown 是一种带格式规范的极简的纯文本格式,广泛被当前各种大模型采用。你可以理解为 Markdown 是 AI 原生的格式。熟悉 Mardkown 语法对编写技能、学习 AI 写作等很有帮组。


为什么用 Markdown?

Markdown 是一种轻量级标记语言,让你在纯文本中就能表达排版意图。对小说创作者来说,它的好处很直接:专注写作,而非排版。 你不需要在菜单里翻找按钮,只用几个简单的符号就能标记标题、强调、分隔——写完之后可以导出为 Word、PDF、电子书等各种格式。


一、标题

标题用 # 号开头,# 越多层级越深。小说写作中最常用的是章节标题和小节标题。

# 第一章 黎明之前
## 第一节 出发
### 场景一:雨夜

效果:

第一章 黎明之前

第一节 出发

场景一:雨夜

写作建议:# 作为章标题,## 作为节标题,### 用于场景切换或时间跳转的小标记,一般不需要更深的层级。


二、段落与换行

Markdown 中,两段文字之间空一行即为分段。这和你在 Word 里按两次回车的效果一样。

他推开门,走进了那间久无人住的屋子。空气中弥漫着陈旧的木头气味。

窗外的月光透过破碎的玻璃洒进来,在地板上画出一道惨白的光痕。

如果你只想在段落内换行(不产生段间距),可以放一个换行,而不是空行(FeelFish 做了支持,一个换行也会有换行,但是不产生间距)。

他推开门,走进了那间久无人住的屋子。空气中弥漫着陈旧的木头气味。
窗外的月光透过破碎的玻璃洒进来,在地板上画出一道惨白的光痕。

三、强调与着重

这是小说创作者最常用的格式之一——用来标记人物内心独白、特殊词汇、或需要强调的语气。

写法效果常见用途
*斜体文字*斜体文字内心独白、书信、回忆
**粗体文字**粗体文字重点强调、关键词
***粗斜体***粗斜体极强烈的语气或呐喊
~~删除线~~删除线角色划掉的文字、修改痕迹

写作示例:

她盯着那封信,心里只有一个念头:*这不可能是真的。*

"你**必须**在天亮之前离开。"老人的声音不容置疑。

四、分隔线(场景切换)

小说中经常需要表示场景切换、时间跳跃或视角转换。在 Markdown 里用三个或以上的短横线、星号、下划线来画分隔线:

她关上了门,再也没有回头。

---

三年后。阳光明媚的午后,街角的咖啡馆里人声鼎沸。

三种写法都可以:---***___,效果一样。建议统一使用 ---,保持风格一致。


五、引用

引用块用 > 开头,适合在小说中插入书信、日记、新闻报道、碑文等嵌入式文本。

他打开那本泛黄的日记,第一页写着:

> 1987年3月14日,晴。
>
> 今天我做了一个决定。如果一切顺利,明天这个时候,
> 我将不在这座城市的任何一个角落。

他的手指微微颤抖。

多层嵌套引用用 >> 表示:

> 她在信中写道:
>
>> 如果你读到这封信,说明我已经走了。
>> 不要来找我。

六、列表

小说正文里列表不常用,但在大纲、设定集、角色档案中很实用。

无序列表(用 -*+ 开头):

- 主要角色
  - 林远舟:男主,退役军人,沉默寡言
  - 苏晚:女主,记者,性格倔强
- 次要角色
  - 老陈:酒馆老板

有序列表(用数字加 . 开头):

1. 第一幕:日常与伏笔
2. 第二幕:冲突爆发
3. 第三幕:高潮与转折
4. 第四幕:结局

七、代码与等宽字体

在小说中偶尔需要表示电脑屏幕上的文字、短信内容、终端输出等"非自然语言"的内容,可以用反引号:

行内代码——用单个反引号包裹:

屏幕上闪烁着一行字:`ACCESS DENIED`。

代码块——用三个反引号包裹整段:

手机屏幕亮了,弹出一条消息:

```
发件人:未知号码
你确定要打开那扇门吗?
```

八、链接与图片

写作笔记中可能会用到参考链接和图片。

链接:

关于这段历史的考证,参见[维基百科](https://zh.wikipedia.org)。

图片:

![场景草图](images/scene01.png)

图片语法就是在链接前面加一个 !。方括号里的文字是图片无法显示时的替代说明。


九、脚注

部分 Markdown 编辑器支持脚注功能,适合在小说中添加译注、历史背景说明等:

那一年,整个城市都在谈论"银河计划"[^1]。

[^1]: "银河计划"是虚构的太空移民项目,灵感来源于20世纪60年代的登月竞赛。

十、特殊排版技巧

居中文本

标准 Markdown 不支持居中,但许多编辑器和导出工具支持 HTML 标签:

<div align="center">

**第二卷**

*风起云涌*

</div>

对话排版

中文小说的对话通常用引号直接分段书写即可:

"你要去哪儿?"她站在门口问。

"出去走走。"他没有回头。

"现在?外面在下雨。"

他停顿了一下:"正好。"

每句对话独立成段,这是最干净的写法。

作者注释与写作备忘

你可以用 HTML 注释在文稿中留下只给自己看的备注,导出时不会显示:

她走进了那间咖啡馆。
<!-- TODO: 这里需要补充环境描写,咖啡馆的氛围要和第三章呼应 -->
老板抬起头,认出了她。

速查表

功能语法示例
章标题# 标题# 第一章 破晓
节标题## 标题## 第三节 重逢
斜体*文字*内心独白
粗体**文字**强调
分隔线---场景切换
引用> 文字书信、日记
无序列表- 项目角色清单
有序列表1. 项目大纲
行内代码`文字`屏幕文字
链接[文字](网址)参考资料
图片![说明](路径)场景草图
注释<!-- 内容 -->写作备忘

最后一点建议:Markdown 的精髓是"够用就好"。写小说时不要过度追求排版花样,让符号为内容服务,而非反过来。打开编辑器,开始写就对了。