Title Serial Number

approved

by Domenic

Add serial numbers to your Markdown title.

20 stars7,382 downloadsUpdated 2mo agoMIT
View on GitHub

Obsidian Title Serial Number Plugin

A powerful Obsidian plugin that automatically adds customizable serial numbers to your markdown headings.

quick start

Features

  • Multiple Number Styles: Support for 7 different numbering styles

    • Arabic numerals (1, 2, 3...)
    • Chinese lowercase (一, 二, 三...)
    • Chinese uppercase (壹, 贰, 叁...)
    • Roman uppercase (I, II, III...)
    • Roman lowercase (i, ii, iii...)
    • Alphabetic uppercase (A, B, C...)
    • Alphabetic lowercase (a, b, c...)
  • Flexible Level Configuration: Choose which heading levels (H1-H6) to apply numbering

  • Per-Level Style Customization: Set different number styles for each heading level

  • Custom Separator: Configure the separator between numbers (e.g., ., -, /)

  • Live Preview: See how your serial numbers will look in real-time while configuring

Commands

CommandDescription
Set Serial NumberAdd serial numbers to all headings in the current document
Clear Serial NumberRemove all serial numbers from headings in the current document

Configuration

Access the plugin settings through Settings → Community Plugins → Title Serial Number Plugin.

configuration interface

Settings Options

OptionDescription
Start Heading LevelWhich heading level to start adding serial numbers (H1-H6)
End Heading LevelWhich heading level to stop adding serial numbers (H1-H6)
Number SeparatorSeparator between level numbers (default: .)
H1-H6 Number StyleChoose the numbering style for each heading level

Example

Input

# Introduction

## Background

### History

### Current State

## Methods

### Approach A

### Approach B

# Conclusion

Output (with default settings: Arabic, separator .)

# 1 Introduction

## 1.1 Background

### 1.1.1 History

### 1.1.2 Current State

## 1.2 Methods

### 1.2.1 Approach A

### 1.2.2 Approach B

# 2 Conclusion

Output (with mixed styles: H1=Roman, H2=Arabic, H3=Alpha lowercase)

# I Introduction

## I.1 Background

### I.1.a History

### I.1.b Current State

## I.2 Methods

### I.2.a Approach A

### I.2.b Approach B

# II Conclusion

Installation

From Obsidian Community Plugins

  1. Open Obsidian Settings
  2. Go to Community Plugins and disable Safe Mode
  3. Click Browse and search for "Title Serial Number"
  4. Install and enable the plugin

Manual Installation

  1. Download the latest release from GitHub Releases
  2. Extract the files to your vault's .obsidian/plugins/obsidian-title-serial-number-plugin/ folder
  3. Reload Obsidian and enable the plugin in Community Plugins settings

License

MIT License - see LICENSE for details.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.