Caption Numbering

Automatically number figure/table captions using 6th-level headings (######) in Obsidian.

中文文档

Features

• Tag-based auto-numbering: Define custom tags (e.g., 图 / Figure, 表 / Table, Algorithm). Headings starting with ###### 图 xxx are automatically numbered as ###### 图 1 xxx, ###### 图 2 xxx, etc.
• Custom tag management: Add, edit, or delete tags in the settings panel. Each tag gets its own independent counter.
• Chapter prefix numbering（Optional）: Optionally prepend the chapter number from section headings (e.g., ###### 图 1-1 xxx when under ## 1 System Overview).
• Smart tag suggestion: Type ###### and a dropdown automatically appears to select a tag.
• Auto-numbering: Optional timer-based auto-numbering (every 10 seconds) to keep captions up to date.
• Wikilink cross-reference sync: When a caption heading is renumbered, all [[#caption]] wikilinks pointing to it are automatically updated:
  • [[#图 1 系统架构]] → [[#图 2 系统架构|图 2]] (target + display text updated)
  • [[#图 1 系统架构]] → [[#图 1 系统架构|图 1]] (display text auto-added if missing)
• Front matter support: Per-document settings via YAML front matter (e.g., caption numbering: 图, 表, auto).
• Remove numbering: One-click command to strip all caption numbers.

How to install

From Obsidian Community Plugins (recommended)

1. Go to Settings → Community Plugins → Browse.
2. Search for "Caption Numbering".
3. Click Install, then Enable.

Manual installation

1. Download the latest release from the Releases page.
2. Unzip into your vault's .obsidian/plugins/caption-numbering/ folder.
3. Enable the plugin in Settings → Community Plugins.

How to use

Basic workflow

1. Open the Command Palette (Cmd/Ctrl + P).
2. Type one of the following commands:

3. You can also assign hotkeys to these commands in Settings → Hotkeys.

Writing captions

There are two ways to create captions:

Method A — Using the tag suggestion popup:

1. Type ###### (six hash marks + space).
2. A dropdown appears with your configured tags.
3. Select a tag (e.g., 图).
4. The cursor is placed after the tag, ready for you to type the caption text.
5. Result: ###### 图 系统架构图

Method B — Manually:

###### 图 系统架构图
###### 表 数据对比
###### 算法 快速排序

Running numbering

After writing captions, run the Number captions in document command. The result:

###### 图 1 系统架构图
###### 图 2 流程图
###### 表 1 数据对比
###### 算法 1 快速排序

Chapter prefix numbering

If your document has numbered section headings like:

## 1 系统概述
  ###### 图 系统架构图
  ###### 图 流程图
## 2 功能设计
  ###### 图 部署图

Enable "章节前缀" (Chapter Prefix) in settings. The result:

## 1 系统概述
  ###### 图 1-1 系统架构图
  ###### 图 1-2 流程图
## 2 功能设计
  ###### 图 2-1 部署图

Cross-referencing with wikilinks

You can reference captions using Obsidian's built-in wikilink syntax:

[[#图 1 系统架构]]

After numbering, this automatically becomes:

[[#图 1 系统架构|图 1]]

If the caption is renumbered, the link updates automatically:

[[#图 2 系统架构|图 2]]

Per-document settings via front matter

Add to your document's front matter:

---
caption numbering: 图, 表, auto
---

This sets the tags to 图 and 表 and enables auto-numbering for this document only.

Available options:

• 图, 表, 算法 — comma-separated tag names
• auto — enable auto-numbering
• off — disable numbering for this document

Settings

Development

# Install dependencies
npm install

# Build for development (watch mode)
npm run dev

# Build for production
npm run build

# Run tests
npm test

Suggested to apply together with

Number-Headings@onlyafly

Better-Export-pdf@l1xnan

License

MIT

Similar Project

EasyReference@mcardZH

Number-Headings-Obsidian@onlyafly