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

如何快速掌握Typora自动编号功能：面向新手的完整实战指南

news 2026/6/14 9:14:07

如何快速掌握Typora自动编号功能：面向新手的完整实战指南

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

Typora自动编号功能是Typora插件中最实用的功能之一，它彻底解决了文档编写中手动维护编号的繁琐问题。无论你是撰写技术文档、学术论文还是日常笔记，自动编号都能让你的文档结构更加清晰专业。本文将为你详细介绍如何高效使用这一功能，从基础配置到高级技巧，带你全面掌握自动编号的实战应用。

为什么你需要自动编号功能？

在撰写长篇文档时，你是否经常遇到这些困扰？

📝手动编号耗时费力：每次添加新章节都要手动更新所有编号
🔄维护成本极高：删除或移动内容后，编号需要重新调整，极易出错
📊导出兼容性问题：传统CSS主题实现的编号在导出PDF时经常丢失
🎨格式不统一：不同元素的编号风格不一致，影响文档专业性

Typora插件的自动编号功能正是为了解决这些痛点而生，通过智能的CSS计数器和灵活的配置系统，为Markdown文档提供了一站式的自动编号解决方案。

快速安装与启用指南

安装Typora插件

首先，你需要安装Typora插件。如果你的Typora版本大于等于0.9.98，可以按照以下步骤操作：

下载插件源码压缩包
进入Typora安装路径，找到包含window.html的文件夹
将解压得到的plugin文件夹粘贴到该目录下
运行安装脚本（Windows使用PowerShell运行install_windows.ps1，Linux运行install_linux.sh）
重启Typora验证安装

安装完成后，在正文区域点击鼠标右键，如果能看到"常用插件"栏目，说明安装成功。

启用自动编号功能

自动编号功能位于插件列表的第35项。启用方法非常简单：

在Typora中右键点击正文区域
选择"常用插件" → "插件配置"
找到"auto_number"选项并启用

你也可以使用工具栏搜索功能，按Ctrl+J调出搜索框，输入"auto"快速找到自动编号插件。

核心功能详解

支持编号的元素类型

自动编号插件支持多种元素的自动编号：

元素类型	默认启用	功能描述
章节标题 (H1-H6)	✅	支持多级标题的层次化编号
大纲目录	✅	侧边栏大纲同步显示编号
TOC目录	❌	可选的表格目录编号
表格	❌	为每个表格自动编号
图片	❌	为每张图片自动编号
代码块	❌	为每个代码块自动编号

编号格式预设方案

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

# 技术文档编号方案 content-h1 = "{c1:d}" content-h2 = "{c1:d}.{c2:d}" content-h3 = "{c1:d}.{c2:d}.{c3:d}" # 学术论文编号方案 content-h1 = "{c1:ur}" content-h2 = "{c1:ur}.{c2:d}" content-h3 = "{c1:ur}.{c2:d}.{c3:la}" # 中文报告编号方案 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	日语格式	壱, 弐, 参

实战配置教程

基础配置设置

在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" # 表格编号位置

自定义编号格式

你可以根据需要自定义编号格式，支持混合样式：

# 混合样式示例 - 适合技术文档 content-h1 = "{c1:d}" content-h2 = "Section {c1:d}.{c2:d}" content-h3 = "{c1:d}.{c2:d}.{c3:la}" table = "Table {t:ua}" image = "Figure {i:d}" fence = "Listing {f:d}" # 学术风格编号 content-h1 = "Chapter {c1:ur}" content-h2 = "Section {c1:ur}.{c2:d}" content-h3 = "{c1:ur}.{c2:d}.{c3:la}"

场景化配置示例

场景一：技术文档编写

[[auto_number.LAYOUTS]] name = "TechDocument" selected = true [auto_number.LAYOUTS.layout] content-h1 = "{c1:d}" content-h2 = "{c1:d}.{c2:d}" content-h3 = "{c1:d}.{c2:d}.{c3:d}" content-h4 = "{c1:d}.{c2:d}.{c3:d}.{c4:d}" table = "Table {t:d}" image = "Figure {i:d}" fence = "Listing {f:d}"

场景二：中文报告制作

[[auto_number.LAYOUTS]] name = "ChineseReport" selected = true [auto_number.LAYOUTS.layout] content-h1 = "第{c1:cjk}章" content-h2 = "{c1:cjk}.{c2:cjk}" content-h3 = "{c1:cjk}.{c2:cjk}.{c3:cjk}" content-h4 = "{c1:cjk}.{c2:cjk}.{c3:cjk}.{c4:cjk}" table = "表{t:cjk}" image = "图{i:cjk}"

高级技巧与优化

导出PDF兼容性

与其他实现方式不同，Typora插件的自动编号功能完美解决了导出PDF时编号丢失的问题。这得益于插件通过修改内置函数，确保编号在导出时依然有效。

// 插件核心代码片段 _fixExportToPDF = () => { this.utils.exportHelper.register(this.fixedName, () => { return `body {font-variant-ligatures: no-common-ligatures;} ` + this._getCSS(true) }) }