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

Text Progress Bar

michaeladamsmichaeladams7k downloads

Display low-fi text progress bars in your notes.

Add to Obsidian
  • Overview
  • Scorecard
  • Updates2

Adds text-based and emoji progress bars to Obsidian.

Usage

To create a progress bar, start a code block with "text-progress-bar".

A minimal bar contains the bars label, how much is complete, and the total number.

Defaults will be taken from the plugin settings.

```text-progress-bar
Books read:1/10
```

Default example

Optionally, all the settings can be specified:

```text-progress-bar
Books read:5/10
transition:|
fill:▓
empty: 
prefix:[
suffix:]
length:10
```

Default example

Note that empty has " " - a special empty character.

Want emojis? We got em:

```text-progress-bar
Chickens hatched:5/10
fill:🐥
empty:🥚
prefix:[
suffix:]
length:10
```

Default example

Specify a transition to display a character for partial completion:

```text-progress-bar
Thats no moon:10/20
transition: 🌘,🌗,🌔
fill:🌕
empty:🌑
prefix:[
suffix:]
length:3
```

Default example

And use decimal numbers to specify the partial completion of emojis

```text-progress-bar
Books read:5.5/10
transition:📖
fill:📗
empty:📕
length:10
```

Or use ASCII characters for the transition:

```text-progress-bar
Books read:5/10
transition:⣦
fill:⣿
empty:⣀
prefix:⎸
suffix:⎹
length:3
```

ASCII Transition

Multiple progress bars.

Progress bars can be grouped together in one block using multiple labels.

```text-progress-bar
JAN:10.0/10
FEB:1.0/10
MAR:5.5/10
transition:📖
fill:📗
empty:📕
length:10
```

Grouped progress

Installation

The plugin can be installed manually:

  1. Download the latest release
  2. Extract the contents into your ./obsidian/plugins/ folder
  3. Reload Obsidian
  4. Enable the plugin from your settings
HealthFair
ReviewCaution
About
Insert text-based and emoji progress bars into notes using a text-progress-bar code block. Customize fill/empty characters and transitions, show decimal partial progress, and group multiple labeled bars in one block.
VisualizationEmojiMarkdown
Details
Current version
0.2.0
Last updated
3 years ago
Created
4 years ago
Updates
2 releases
Downloads
7k
Compatible with
Obsidian 0.15.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
michaeladamsmichaeladams
michaeladams.dev
GitHubmichaeladams
  1. Community
  2. Plugins
  3. Visualization
  4. Text Progress Bar

Related plugins

Markwhen

Create timelines, gantt charts, calendars, and more using markwhen.

AnyBlock

Take any fragment as a block and render it into multiple effects.

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.

Advanced Canvas

Supercharge your canvas experience. Create presentations, flowcharts and more.

Outliner

Work with your lists like in Workflowy or Roam Research.

Excalidraw

Visual PKM powerhouse. Create and edit Excalidraw drawings.

Breadcrumbs

Visualise the hierarchy of your vault using a breadcrumb trail or matrix view.

Maps

Adds a map layout to bases so you can display notes as an interactive map view.

Mermaid Tools

Improved Mermaid.js experience: visual toolbar with common elements and more.

Consistent Attachments and Links

Move note attachments and update links automatically.