Search...Search plugins and themes...
⌘K
Sign in
  • Get started
  • Download
  • Pricing
  • Enterprise
  • Account
  • Obsidian
  • Overview
  • Sync
  • Publish
  • Canvas
  • Mobile
  • Web Clipper
  • CLI
  • Learn
  • Help
  • Developers
  • Changelog
  • About
  • Roadmap
  • Blog
  • Resources
  • System status
  • License overview
  • Terms of service
  • Privacy policy
  • Security
  • Community
  • Plugins
  • Themes
  • Discord
  • Forum / 中文论坛
  • Merch store
  • Brand guidelines
Follow us
DiscordTwitterBlueskyThreadsMastodonYouTubeGitHub
© 2026 Obsidian

Section Meter

Martino WongMartino Wong105 downloads

Shows stats (wordcount, reading time) beside headings and in the status bar

Add to Obsidian
  • Overview
  • Scorecard
  • Updates11

Section Meter is an Obsidian plugin that shows useful writing statistics beside your note title and headings.

See the word count, character count, and estimated reading time for each section without leaving the editor. You can also add writing targets and follow your progress as you write.

Created by Martino Wong with Codex.

How it works

Each heading gets a small badge showing statistics for the section beneath it.

A section continues until the next heading of the same or a higher level. This means a parent heading includes everything inside its smaller subheadings.

For example:

# Chapter one

Introduction...

## First scene

Scene text...

## Second scene

More text...

The badge beside Chapter one counts the introduction and both scenes. Each scene heading counts only its own section.

Features

  • Statistics beside headings from # to ######
  • Whole-note statistics beside the note title
  • Word, character, and estimated reading-time counts
  • Whole-note and selected-text statistics in the status bar
  • Section statistics for selected text
  • Writing targets for a whole note or individual sections
  • Progress bars that make targets easy to follow
  • Adjustable reading speed
  • Optional spaces in character counts
  • Customizable labels and separators
  • Options to hide empty or very short sections
  • Fast, local counting with no text sent anywhere

Section Meter focuses on readable prose. It leaves out frontmatter, code blocks, inline code, embeds, comments, and HTML when calculating statistics.

Writing targets

Add a Target: line to set a writing goal.

Place it before the first heading to create a target for the whole note:

Target: 1200 words

# My draft

Start writing here...

Place it inside a section to create a target for that heading:

# Introduction

Target: 250 words

Introduction text...

## Background

Target: 1800 characters

Background text...

You can create targets using:

  • Words: Target: 250 words
  • Characters: Target: 1800 characters
  • Reading time: Target: 3 min, Target: 3m, or Target: 2m 30s

Target lines are not included in your statistics.

A target on a parent heading covers its complete section, including smaller subheadings. It remains visible in the status bar while you work inside those subheadings. If a smaller section has its own target, that target takes priority while you are inside it.

Progress bars change colour as you approach your target. They turn green when the target is reached and red when you pass the configured overage warning.

Customization

Section Meter's settings let you choose:

  • Which statistics appear beside headings
  • Which statistics appear in the status bar
  • Whether character counts include spaces
  • Your preferred reading speed
  • Count-based or percentage-based target labels
  • When target overage warnings appear
  • The minimum section size required to show a badge
  • Whether badges appear for empty sections

Limitations

Section Meter currently works in the editor, not Reading view.

Counts are calculated using fast Markdown cleanup rather than Obsidian's complete renderer. Content generated by plugins such as Dataview, rendered transclusions, and complex mathematics may therefore produce slightly different results from what appears on screen.

Manual installation

Download or build the plugin, then copy these files into .obsidian/plugins/section-meter inside your vault:

  • main.js
  • manifest.json
  • styles.css

Restart Obsidian—or reload your installed plugins—then enable Section Meter under Community plugins.

Development

Install the dependencies:

npm install

Run the tests:

npm test

Build the plugin:

npm run build

For local testing, copy or symlink this repository into your vault's .obsidian/plugins/section-meter directory. Build the plugin, then enable it in Obsidian.

License

Section Meter is available under the MIT License.

It is an independent community plugin and is not affiliated with, endorsed by, or sponsored by Obsidian.

HealthExcellent
ReviewPassed
About
Show reading-time, word, and character badges beside Markdown headings and the note title in the editor. Count readable prose per section (excluding frontmatter, code blocks, inline code, embeds, comments, and HTML), include nested subheadings in parent counts, and display whole-note and selected-text stats with minute-and-second timing based on adjustable reading speed.
WritingStatus barMarkdown
Details
Current version
0.11.7
Last updated
2 days ago
Created
3 weeks ago
Updates
11 releases
Downloads
105
Compatible with
Obsidian 1.11.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
Martino WongMartino Wongmartinowong
GitHubmartinowong
  1. Community
  2. Plugins
  3. Writing
  4. Section Meter

Related plugins

Typewriter Mode

Typewriter scroll, writing focus, current line highlight, paragraph dimming, and more!

Better Word Count

Count the words of selected text in the editor.

Reading Time

Add the current note's reading time to the status bar.

Plugin Update Tracker

Know when installed plugins have updates and evaluate the risk of upgrading.

Importer

Convert your data to Markdown files you can use in Obsidian. Works with Apple Notes, OneNote, Evernote, Notion, Google Keep, and many other formats.

Outliner

Work with your lists like in Workflowy or Roam Research.

Longform

Helps you write and edit novels, screenplays, and other long projects.

Consistent Attachments and Links

Move note attachments and update links automatically.

Various Complements

Complete words similar to auto-completion in an IDE.

LanguageTool Integration

advanced spell/grammar checks with the help of language-tool.