I write long-form prose in Obsidian and I didn’t like the way that line numbers included headings and blank lines. I couldn’t find a plugin that did this, so I built one this morning. It’s my first Obsidian plug-in. Hope it’s of some use to someone besides me.
Specifically,
Paragraph Numbers adds a gutter that numbers your paragraphs sequentially, skipping everything that isn’t prose:
- YAML frontmatter
- Headings
- Code fences
- Horizontal rules
- Blank lines
Only the first line of each paragraph gets a number. Continuation lines are left blank.

Recommended companion settings (Settings → Editor):
- Turn off Line numbers — they’re redundant now
- I set Properties in document to “Hidden” for a cleaner view
Works on desktop and mobile. No build step — it’s a single plain JS file using CodeMirror 6’s gutter API.
Install via BRAT: kvarnelis/obsidian-paragraph-numbers
I’m not sure why I can’t add a link to the github, I guess my account is too new.
