Skip to content

Latest commit

 

History

History
67 lines (52 loc) · 1.03 KB

README.md

File metadata and controls

67 lines (52 loc) · 1.03 KB

Markdown Numbered Header

Neovim plugin for automatically numbering markdown headers.

Features

  • Customizable starting level
  • Automatic renumbering on save
  • Support per file control using comments

Installation

Using lazy.nvim:

return {
  "fireond/number-markdown.nvim",
  opts = {}
}

Configuration options

{
  start_level = 2,    -- Start numbering from h2 headers
  auto_update = true  -- Auto-update on save, can be boolean or function
}

Usage

Functions

require("number-markdown").number_headers()
require("number-markdown").clear_numbers()
require("number-markdown").toggle_auto_update()
require("number-markdown").get_auto_update_status()

Commands

:MDNumberHeaders
:MDClearHeaders
:MDToggleAutoUpdate

Per file control

Search lines with syntax set property = value. Examples:

  • set start_level:
<!-- set start_level=1 -->
# 1 H1
## 1.1 H2
## 1.2 H2
  • set counter:
<!-- set start_level=1 -->
# 1 H1
## 1.1 H2
<!-- set counter=5 -->
## 1.5 H2