当前位置：首页 > news >正文

Typora自动编号插件：彻底解决文档编号难题的完整指南

news 2026/6/16 23:13:30

Typora自动编号插件：彻底解决文档编号难题的完整指南

【免费下载链接】typora_pluginTypora Plugin. Feature Enhancement Tool | Typora 插件，功能增强工具项目地址: https://gitcode.com/gh_mirrors/ty/typora_plugin

Typora插件系统中的自动编号功能为Markdown文档提供了智能化的编号解决方案，通过CSS计数器技术实现章节、表格、图片和代码块的自动编号，彻底告别手动维护编号的繁琐工作。在撰写技术文档、学术论文或长篇教程时，自动编号插件能够显著提升写作效率和文档的专业性。

痛点分析：为什么需要自动编号？

传统Markdown写作中，文档编号常常面临以下挑战：

痛点	传统方案	自动编号优势
手动维护繁琐	每次添加新章节都需要手动更新所有编号	智能动态编号，自动适应文档结构变化
维护成本高	删除或移动内容后需要重新调整编号	自动重新计算，编号始终保持一致
导出兼容性差	CSS主题编号在导出PDF时经常丢失	完美支持HTML和PDF导出，编号不丢失
格式不统一	不同元素的编号风格不一致	统一配置，多种编号样式可选
多位置不同步	正文、大纲、目录编号不一致	三位置同步更新，保持一致

如图所示，自动编号插件实现了左侧大纲导航栏的红色数字编号与右侧章节标题的层级编号完美同步，表格也拥有独立的编号系统（如Table 3-1），形成了完整的文档编号体系。

功能解析：自动编号能做什么？

支持编号的元素类型

自动编号插件支持对文档中所有重要元素进行智能编号：

元素类型	默认启用	应用场景
章节标题 (H1-H6)	✅	技术文档、学术论文的章节编号
大纲目录	✅	侧边栏大纲同步显示编号，便于导航
TOC目录	❌	可选的表格目录编号
表格	❌	技术文档中的表格编号
图片	❌	论文和教程中的图片编号
代码块	❌	编程文档中的代码示例编号

核心技术原理

自动编号基于CSS计数器机制实现，通过巧妙的CSS选择器和计数器管理，实现了以下功能：

层级管理：支持多级标题的嵌套编号（如1.1、1.1.1）
智能递增：自动识别文档结构变化，实时更新编号
位置同步：正文、大纲、导出三个位置的编号保持一致性
样式灵活：支持多种数字格式和自定义样式

配置指南：5分钟快速上手

基础配置选项

在settings.user.toml文件中配置自动编号插件：

[auto_number] # 启用插件 ENABLE = true # 各元素编号开关 ENABLE_OUTLINE = true # 大纲编号 ENABLE_CONTENT = true # 正文编号 ENABLE_TOC = false # TOC编号 ENABLE_TABLE = false # 表格编号 ENABLE_IMAGE = false # 图片编号 ENABLE_FENCE = false # 代码块编号 # 样式设置 FONT_FAMILY = "monospace" # 编号字体 ALIGN = "center" # 对齐方式 POSITION_TABLE = "after" # 表格编号位置 # 导出兼容性 ENABLE_WHEN_EXPORT = true # 导出时保留编号

预设编号方案

插件内置了多种预设编号布局，满足不同场景需求：

方案名称	标题格式示例	适用场景
Decimal-H2	1, 1.1, 1.1.1	通用技术文档（默认）
Decimal-H1	1, 1.1, 1.1.1	从一级标题开始编号
RomanNumeral	I, A.1, (a)	学术论文格式
ChineseThesis	一、（一）、1.	中文论文格式

自定义编号格式语法

编号格式采用类Python f-string语法，支持丰富的计数器样式：

# 技术文档示例 content-h1 = "{c1}" content-h2 = "{c1}.{c2}" content-h3 = "{c1}.{c2}.{c3}" # 学术论文示例 content-h1 = "{c1:ur}" content-h2 = "{c1:ur}.{c2:ua}" content-h3 = "{c1:ur}.{c2:ua}.{c3}" # 中文文档示例 content-h1 = "第{c1:cjk}章" content-h2 = "{c1:cjk}.{c2:cjk}" content-h3 = "{c1:cjk}.{c2:cjk}.{c3:cjk}"

支持的计数样式

样式代码	描述	示例
d	十进制数字	1, 2, 3
dlz	前导零十进制	01, 02, 03
lr	小写罗马数字	i, ii, iii
ur	大写罗马数字	I, II, III
la	小写字母	a, b, c
ua	大写字母	A, B, C
cjk	中文数字	一, 二, 三
scf	中文大写	壹, 贰, 叁
jf	日语格式	壱, 弐, 参

实战案例：常见场景配置

场景一：技术文档编号方案

[[auto_number.LAYOUTS]] name = "技术文档" selected = true [auto_number.LAYOUTS.layout] content-h1 = "{c1}" content-h2 = "{c1}.{c2}" content-h3 = "{c1}.{c2}.{c3}" content-h4 = "{c1}.{c2}.{c3}.{c4}" table = "表{t}" image = "图{i}" fence = "代码{f}"

场景二：学术论文编号方案

[[auto_number.LAYOUTS]] name = "学术论文" selected = true [auto_number.LAYOUTS.layout] content-h1 = "{c1:ur}" content-h2 = "{c1:ur}.{c2:ua}" content-h3 = "{c1:ur}.{c2:ua}.{c3}" content-h4 = "{c1:ur}.{c2:ua}.{c3}.{c4:la}" table = "Table {t:ur}" image = "Fig. {i:ur}"

场景三：中文报告编号方案

[[auto_number.LAYOUTS]] name = "中文报告" selected = true [auto_number.LAYOUTS.layout] content-h1 = "第{c1:cjk}章" content-h2 = "{c1:cjk}.{c2:cjk}" content-h3 = "{c1:cjk}.{c2:cjk}.{c3:cjk}" table = "表{t:cjk}" image = "图{i:cjk}" fence = "代码块 {f}"

高级技巧：自定义与扩展

混合样式编号

支持在同一编号中混合使用不同样式，创建复杂的编号格式：

# 混合样式示例：Section 1-A.i content-h3 = "Section {c1:d}-{c2:ua}.{c3:lr}" # 附录编号：Appendix A.1.a content-h4 = "Appendix {c1:ua}.{c2:d}.{c3:la}"

选择性启用编号

通过CSS变量实现条件编号显示，优化阅读体验：

/* 只在打印时显示编号 */ @media print { #write > h1:before { content: var(--count-content-h1); } } /* 悬停时显示编号 */ #write > h1:hover:before { content: var(--count-content-h1); }