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

One note, a few improvements: a vault-image banner, a grouped itinerary, and code that fits its callout.
Convert Markdown tables to HTML and keep inline LaTeX rendered in Reading View and Live Preview. See the converted table · Release notes
Find each group under Settings → Patches. Open a feature guide for examples.
| Settings group | Feature | What you can do |
|---|---|---|
| Callouts | Callout editor | Edit, preview, and convert callouts. Choose folders to check for GitHub and match code backgrounds. |
| Editor | Active line | Mark the current line in the margin and highlight its line number. |
| Heading levels | Show H1–H6 labels beside headings in reading and editing views. | |
| Line Width | Readable columns | Set the maximum column width globally or for a single note. |
| Math Format | Display math | Indent and align formulas. |
| Patch Banner | Note covers | Use a vault image, animation, or video as a cover. Set its width per note. |
| Patch Icons | File and folder icons | Choose Lucide icons or brand marks and set their colors. |
| Patch Mermaid | Diagrams | Number flowchart steps and watch the arrows play in order. Check all diagrams in a note and jump to syntax errors. |
| PDF Export | PDF navigation | Add heading bookmarks and same-note heading links to desktop exports. |
| No settings required | HTML tables | Visually edit merged cells, grouped headers, and captions. Convert Markdown tables. |
Requires Obsidian 1.15.0 or later. Patches is available in the Community Directory.
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.
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.
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.
Start with troubleshooting. When reporting a bug, include Obsidian/Patches versions, OS, theme, view mode, reproduction steps, and a small example or recording.
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
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.
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.
MIT.