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

Patches

yaroxywithyou@gmail.com[email protected]76 downloads

Focused fixes and enhancements for Obsidian.

Add to Obsidian
Patches screenshot
Patches screenshot
Patches screenshot
Patches screenshot
Patches screenshot
  • Overview
  • Scorecard
  • Updates8

Patches

Focused fixes and enhancements for Obsidian.

Edit tables and callouts, shape your reading space, and make diagrams and exported PDFs more useful.

Install · Website · User guide · Changelog · Report an issue

A Kyoto travel note combining an autumn banner, a merged itinerary table, and a callout with tinted code backgrounds and syntax highlighting

One note, a few improvements: a vault-image banner, a grouped itinerary, and code that fits its callout.

New in 0.5.1

Convert Markdown tables to HTML and keep inline LaTeX rendered in Reading View and Live Preview. See the converted table · Release notes

Features

Find each group under Settings → Patches. Open a feature guide for examples.

Settings groupFeatureWhat you can do
CalloutsCallout editorEdit, preview, and convert callouts. Choose folders to check for GitHub and match code backgrounds.
EditorActive lineMark the current line in the margin and highlight its line number.
Heading levelsShow H1–H6 labels beside headings in reading and editing views.
Line WidthReadable columnsSet the maximum column width globally or for a single note.
Math FormatDisplay mathIndent and align formulas.
Patch BannerNote coversUse a vault image, animation, or video as a cover. Set its width per note.
Patch IconsFile and folder iconsChoose Lucide icons or brand marks and set their colors.
Patch MermaidDiagramsNumber flowchart steps and watch the arrows play in order. Check all diagrams in a note and jump to syntax errors.
PDF ExportPDF navigationAdd heading bookmarks and same-note heading links to desktop exports.
No settings requiredHTML tablesVisually edit merged cells, grouped headers, and captions. Convert Markdown tables.

Installation

Requires Obsidian 1.15.0 or later. Patches is available in the Community Directory.

  1. Open Settings → Community plugins → Browse.
  2. Search for Patches, then select Install and Enable.
  3. Open Settings → Patches to choose your settings.

For manual installation, download main.js, manifest.json, and styles.css from the latest release. Put them in <vault>/.obsidian/plugins/patches/, reload Obsidian, and enable Patches.

Official releases contain the Community build with bundled Mermaid. To bundle a different version yourself, see Choose a Mermaid version. The optional Full branch adds remote Mermaid versions for manual source builds. Both use the same plugin ID; installing one replaces the other.

Try it

Enable Obsidian’s Settings → Editor → Readable line length, then give one note a wider column:

---
patch-line-width: 1100
---

Other notes keep their global width. See note properties, commands, and views and platforms for more examples and scope.

Network and privacy

The Community build runs its bundled Mermaid code locally. The icon picker may contact jsDelivr to resolve and download Simple Icons graphic data and matching brand-color JSON. Already-used graphics and available brand colors are cached locally. Missing cached graphics can trigger a download. Icon search text, note contents, and vault file names are not sent in these requests.

The optional Full build can download and execute Mermaid/ELK JavaScript from jsDelivr when Latest or Custom is selected, with access to Obsidian. The cover picker lists vault media locally, and Iconize import reads settings within the vault. Patches has no analytics or telemetry. See network and privacy for details.

Help

Start with troubleshooting. When reporting a bug, include Obsidian/Patches versions, OS, theme, view mode, reproduction steps, and a small example or recording.

Development

Use Node.js 22 or later:

npm ci
npm test
npm run build       # community plugin → dist/community/
npm run docs:dev    # local documentation preview
npm run docs:build  # static site → site/.vitepress/dist/

Install the three plugin files from dist/community/ into the vault’s patches directory and reload the plugin. Integration checks deploy to dev-vault and create temporary fixtures; read integration testing first.

See AGENTS.md for feature design references, release documentation for the plugin workflow, and documentation maintenance for the website.

Design research covers an independent PDF preview tab and incremental bilingual translation. The PDF experiment is awaiting scope review, and translation implementation is deferred. PDF pagination research · Incremental translation research

Choose a Mermaid version

In a separate checkout of the Patches release you want to build, replace 12.1.0 below with your chosen exact version. The install saves it in that checkout’s package and lockfile.

npm install --save-exact [email protected]
npm test
npm run build
npm run check:release

Official release testing covers the pinned version. Other versions can change diagram syntax, layout, or ELK compatibility. Before using the build in your own notes, run node scripts/test-mermaid.mjs /absolute/path/to/dev-vault in a prepared development vault and try your own diagrams. Settings → Patches → Patch Mermaid shows the version actually bundled.

Acknowledgments

Line Width follows the ideas of Editor Width Slider by MugishoMp (MIT), and Patch Icons follows Iconize by Florian Woelki (MIT). Their implementations are written for this plugin; the Iconize importer reads its settings format.

Icons come from Lucide (ISC), Simple Icons (CC0 1.0), and the Iconify packs used by Mermaid. Brand icons are trademarks of their respective owners.

License

MIT.

HealthExcellent
ReviewSatisfactory
About
Edit tables and callouts, shape your reading space, and make diagrams and exported PDFs more useful.
EditingTablesAppearance
Details
Current version
0.5.1
Last updated
23 hours ago
Created
4 months ago
Updates
8 releases
Downloads
76
Compatible with
Obsidian 1.15.0+
Platforms
Desktop, Mobile
License
MIT
Report bugRequest featureReport plugin
Author
yaroxywithyou@gmail.com[email protected]yaroxy
GitHubyaroxy
  1. Community
  2. Plugins
  3. Editing
  4. Patches

Related plugins

Advanced Tables

Improved table navigation, formatting, and manipulation.

Cursor-Smith

Forge your cursor with the most advanced cursor engine there is!

Datacore

An even faster reactive query engine for the data obsessed.

Lapel

Show the heading levels in the gutter of the editor.

Ninja Cursor

Enhance cursor visibility.

Show Whitespace

CSS styles and CM6 extensions to highlight whitespace in Source and Live Preview modes.

CSV Lite

Just open and edit a CSV file in workspace view, no more. Keep it simple.

Minimal Theme Settings

Control the colors and fonts in Minimal Theme.

Hider

Hide interface elements such as tooltips, status bar, titlebar, and more.

LanguageTool Integration

Advanced grammar and spell checking, powered by LanguageTool.