【终极指南】novelWriter章节标题层级设计与自动化排版方案
项目地址: https://gitcode.com/gh_mirrors/no/novelWriter 你是否曾因小说章节标题层级混乱导致排版失控？是否在导出 manuscript 时发现场景分隔符错位？本文将系统解析 novelWriter 标题层级系统的底层逻辑，提供从基础语法到高级自定义的全流程优化方案，帮你构建结构化叙事框架。
读完本文你将掌握：
- 4级标题的精准使用场景与语法规则
- 编号/非编号标题的控制技巧（含!符号高级用法）
- 自定义标题格式字符串的12种变量组合
- 标题解析流程图与常见错误排查指南
- 3个实战案例：常规小说/短篇集/史诗三部曲结构
标题层级语法基础
novelWriter 采用类 Markdown 语法构建标题层级，通过 # 符号数量区分层级，支持1-4级标题。与标准 Markdown 不同，其标题不仅是格式标记，更是小说结构的逻辑划分单元。
基础层级语法表
| 语法 | 层级 | 类型 | 核心作用 | 导出行为 |
|---|---|---|---|---|
# 标题 | 1级 | 分区标题 | 划分小说大单元（如卷/部/幕） | 重置章节计数器，可强制分页 |
## 标题 | 2级 | 章节标题 | 定义故事主线章节 | 递增章节号，支持罗马/阿拉伯数字 |
### 标题 | 3级 | 场景标题 | 标记场景切换点 | 可生成场景分隔符，支持自定义符号 |
#### 标题 | 4级 | 小节标题 | 细分场景内段落群 | 通常内联显示，不影响大纲结构 |
代码示例：基础层级结构
# 第一卷：火星殖民 ## 第三章：红色风暴 ### 3.2 沙尘暴来袭 #### 紧急避难 船员们迅速进入风暴掩体，观察窗外的红色巨浪。
特殊标记：!符号的魔法
在 # 后添加 ! 符号可将标题标记为"非编号"类型，解决特殊章节（序章/幕间/尾声）的排版需求。
| 语法 | 功能 | 典型应用场景 |
|---|---|---|
#! 序章 | 非编号分区 | 前言/楔子/序章 |
##! 幕间休息 | 非编号章节 | 插曲/间奏/哲学思考 |
###! 梦境序列 | 非编号场景 | 回忆杀/梦境/意识流 |
实战案例：sample/content/ba8a28a246524.nwd 中的非编号章节
##! Interlude % 此章节不会被计入章节编号序列 % 导出时将使用自定义格式字符串
标题解析与格式化引擎
novelWriter 的标题处理由 HeadingFormatter 类核心驱动，通过三级处理流程将原始文本转换为结构化标题。
标题解析流程图
计数器系统工作原理
novelWriter 维护独立的分区/章节/场景计数器，通过标题层级自动触发递增逻辑：
- 分区计数器：仅在遇到1级标题时递增（
# 新分区） - 章节计数器：仅在遇到2级编号标题时递增（
## 新章节） - 场景计数器：在3级编号标题处递增（
### 新场景）
关键机制：通过
resetScene()和resetAll()方法实现计数器重置，1级标题默认触发resetScene()，而#!非编号标题不影响任何计数器。
高级自定义：格式字符串语法
通过 Build Settings 中的格式字符串，可完全控制标题的显示样式，支持12种变量占位符与文本组合。
常用格式变量表
| 变量 | 含义 | 示例输出 | 适用层级 |
|---|---|---|---|
%n | 数字编号 | 3 | 所有编号标题 |
%N | 带前缀编号 | Ch.3 | 章节标题 |
%t | 标题文本 | 红色风暴 | 所有标题 |
%r | 罗马数字 | III | 章节/分区 |
%s | 场景符号 | ⋆ | 场景标题 |
预设格式方案
| 标题类型 | 格式字符串 | 输出效果 |
|---|---|---|
| 史诗分区 | "Book %r: %t" | "Book III: The Martian Chronicles" |
| 常规章节 | "Chapter %n: %t" | "Chapter 5: Dust Storm Warning" |
| 场景标题 | "[%n] %t" | "[2] Emergency Shelter" |
| 无编号章节 | "— %t —" | "— Interlude —" |
配置路径：菜单栏 → Project → Build Settings → Headings 选项卡
# 代码层面设置示例（novelwriter/core/buildsettings.py） self.setChapterFormat("Chapter %n: %t", hide=False)
实战场景解决方案
场景1：标准小说结构（三部曲）
#! The Mars Trilogy <!-- 总标题（非编号分区） -->
# Red Mars <!-- 第一部（分区1） -->
## 01 Landing <!-- 章节1 -->
### Arrival <!-- 场景1 -->
### First Steps <!-- 场景2 -->
## 02 Settlement <!-- 章节2 -->
# Green Mars <!-- 第二部（分区2） -->
## 01 Awakening <!-- 章节1（重置章节号） -->
### Rebellion <!-- 场景1 -->
场景2：短篇故事集
#! Martian Short Stories <!-- 总标题 -->
##! The First Expedition <!-- 非编号章节 -->
### Launch <!-- 场景 -->
### Encounter <!-- 场景 -->
##! The Return <!-- 非编号章节 -->
### Homecoming <!-- 场景 -->
场景3：嵌套层级结构（带小节）
# Book One <!-- 分区 -->
## Chapter 01 <!-- 章节 -->
### Morning Routine <!-- 场景 -->
#### Alarm <!-- 小节 -->
#### Breakfast <!-- 小节 -->
### Commute <!-- 场景 -->
常见问题与调试指南
标题层级错误排查清单
- 层级跳跃问题：避免跳过层级（如从#直接到###）
- 符号间距问题：
#与文本间必须有空格（#Title会被视为普通文本） - 计数器异常：检查是否误用
!符号导致编号不递增 - 格式字符串失效：确保变量使用正确（区分大小写）
工具推荐：标题结构可视化
通过 Project → Outline View 可实时查看标题层级结构，异常层级会以橙色标记。导出前建议使用此功能验证结构完整性。
总结与最佳实践
- 层级规划：写作前确定层级规则（建议不超过3级深度）
- 一致命名：保持同层级标题命名风格统一
- 适度注释：对特殊标题添加
%注释说明用途 - 定期验证：使用大纲视图检查层级结构
- 备份配置：导出 Build Settings 配置（JSON格式）以便复用
掌握 novelWriter 标题层级系统，不仅能获得整洁的排版效果，更能通过结构化思维提升叙事逻辑。下一篇我们将深入探讨"基于标题元数据的自动化人物出场统计"，敬请期待。
延伸资源：官方文档 Chapters and Scenes
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
