Better Figures

approved

by SunnyYYLin

Add captions to images using native Markdown syntax even in LIVE PREVIEW. - This plugin has not been manually reviewed by Obsidian staff.

↓ 148 downloadsUpdated 1mo ago0BSD
Install in ObsidianView on GitHub

Better Figures

Add captions to images using native Markdown syntax.

Demo

Features

  • Native Markdown syntax — write ![caption](image.png) and the alt text becomes a centered caption below the image.
  • Reading view — captions rendered via Obsidian's Markdown post-processor.
  • Live Preview — captions rendered with pure CSS, even while editing.
  • Empty alt text — images like ![](image.png) are left unchanged, so existing notes are unaffected.
  • Image embeds — works with both external images and internal ![[image]] embeds.
  • Lightweight — zero dependencies at runtime, no settings needed.

Usage

Write a standard Markdown image:

![Figure 1. Architecture overview](architecture.png)

In both Reading view and Live Preview, Better Figures renders the image with the caption centered below it.

Images with empty alt text are left as-is:

![](architecture.png)

Installation

From Community Plugins (recommended)

  1. Open Obsidian and go to Settings → Community plugins.
  2. Disable Restricted mode if prompted.
  3. Click Browse and search for "Better Figures".
  4. Install and enable the plugin.

Manual

  1. Download the latest release from GitHub Releases.
  2. Copy main.js, manifest.json, and styles.css into <vault>/.obsidian/plugins/better-figures/.
  3. Enable the plugin in Settings → Community plugins.

Development

bun install
bun run dev

Build for release:

bun run build

License

BSD-0-Clause License

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.