Repository navigation
Releases
Patches 0.5.1
Fixed
- Preserve inline LaTeX when converting Markdown tables to HTML. Obsidian renders the formulas in Reading View and Live Preview. View the converted table
Patches 0.5.0
Added
- GitHub folders suggests vault paths as you type. Select a folder to update the callout count for its notes and subfolders. When editing a comma-separated list, a selection replaces just the entry under the cursor.
- Set
patch-banner-widthon a note to use 10–100% of its pane width for the cover. Omitted or invalid values use the vault setting. - Run Check diagrams in this note to check every
patch-mermaidblock with the active Mermaid version. It reads unsaved edits in the editor and the saved file in Reading view. Jump opens the source line and Details shows the parser message.
Changed
- Show Mermaid 12.3.0’s numbered flowchart steps in the diagram guide and the Community Directory screenshot set.
- Callouts on GitHub shows each callout’s line and whether GitHub renders it as an alert or a plain blockquote. Details expands the reasons for one row. Jump goes to the callout in the current view. Long lists scroll below the summary.
- Icons of missing files lists the full vault paths before cleanup. Clicking Remove rechecks each displayed path so a restored file keeps its icon and color.
- Personal builds print the bundled Mermaid version and a reminder to test a custom pin. The README documents how to select an exact version.
- Shorten the plugin manifest description, group the README guides in settings order, and document how pane width and theme padding limit the readable column.
Fixed
- Keep a cover at its configured width while Image Converter resizes or aligns a body image that uses the same attachment. The fix also prevents cover flicker on hover.
- Open the GitHub callout check from Reading view, refresh its count after an external save, and detect changes before jumping. Mermaid source jumps preserve Windows line endings.
Patches 0.4.0
Added
- Add a locally previewable documentation website with feature guides, examples, reference pages, troubleshooting, and local search.
- Automatically build, check, and deploy the documentation to GitHub Pages on pushes to
main; pull requests retain build-only review previews. - Set an exact global Line Width with a numeric input alongside the slider; both line-width sliders now adjust in 1 px steps.
- Choose explorer icons and colors together in Change icon, with a preview, Apply/Cancel, text color, eight theme-aware presets, custom colors, and cached Simple Icons brand colors. Batch color changes preserve different existing icons, and settings explain the two icon sources.
Changed
- Combine the original autumn banner, merged itinerary table, and tinted callout code in the README and homepage demonstration; add switchable homepage demos for icon colors, exact line width, and callout code backgrounds.
- Refresh the user-guide demos for the combined icon/color picker, exact global width input, and nested callout code-block backgrounds in light and dark themes.
- Tint code block backgrounds inside callouts alongside inline code, preserving syntax highlighting and using each nested callout's own color. Rename the existing Callouts toggle to Code background.
- Shorten the README to installation, a feature overview, and support; move detailed usage and examples into the documentation site and omit old-plugin migration guidance from the getting-started flow.
Fixed
- Use a border for the documentation homepage's secondary-link decoration and selector specificity for its code-card text, addressing the Directory preview's documentation CSS warnings.
- Preserve each file's existing color when changing icons for a selection with mixed colors; Keep colors restores that choice before applying.
- Let Enter activate the focused icon-picker buttons while retaining icon selection from the search field.
- Keep the icon picker centered with at least 24 px above and below it, scroll the results within the available height, and keep color controls and Apply/Cancel visible when the interface is zoomed.
Patches 0.3.2
Changed
- Community source and official releases now live on
main; the separatecodex/fullbranch retains opt-in remote Mermaid versions for manual builds. Each branch builds and validates its own distribution by default. - Record Community Directory review failures, causes, accepted warnings, and verification boundaries in a dedicated review history.
Fixed
- Replace deprecated table text insertion commands with selection-aware plain-text and line-break insertion, retaining the editor's undo/redo history.
- Bind native PDF instance methods to their export modal and restore the complete temporary open-method descriptor, including when export throws.
- Render explorer icons using static CSS and per-row image masks instead of attaching style elements, while preserving lazy rendering, path changes, window ownership, and unload cleanup.
- Create detached banner, heading, and table-conversion elements with supported host helpers directly instead of native document fragments.
Patches 0.3.1
Added
- A manual GitHub release workflow that builds and checks both variants, attests the three Community installation files, and prepares a release draft from an existing version tag.
Changed
- Updated installation instructions for the published 0.3.0 release, clarified Community and Full builds, and documented when to remove the old plugin after migration.
- Settings now use the declarative API so individual controls appear in settings search, while retaining alphabetical groups, immediate updates, and reset buttons.
- Simple Icons requests use the host network API with the existing timeout and offline fallback behavior.
- Full builds use native dynamic imports for remote Mermaid modules instead of constructing a function from a string. Community builds still exclude that loader.
- Explicit CodeMirror dependencies match the host API's existing peer versions and remain external to both bundles.
- Build-time icon compression uses a pinned JavaScript implementation with a fixed timestamp so native zlib versions do not change release bytes; the complete icon data remains bundled.
Fixed
- Removed the redundant product name from the plugin description and added a release check to catch it before publishing.
- Sanitize generated Mermaid SVG before inserting DOM nodes, preserving diagram styles, HTML labels, safe local shape references, and note links while removing scripts, event handlers, and unsafe URLs.
- Preserve each note's document when creating banner, heading, table-conversion, and icon elements, and retain the receiver when invoking banner actions.
Patches 0.3.0 — Community and Full builds
Obsidian Patch is now Patches: focused fixes and enhancements for Obsidian, shaped by everyday use.
Requires Obsidian 1.15.0 or later. The plugin ID is now patches.
What's changed
- Two builds from one source tree. These release attachments contain the Community build, with bundled Mermaid 12.3.0 and no remote Mermaid or ELK code loader.
- A Full build remains available from source for people who want Mermaid's Latest and Custom options.
- A migration tool previews and backs up the move from
obsidian-patchtopatches, preserving settings, enabled state, and command hotkeys. - Release checks validate version metadata, build inputs, and the three installable files.
Existing patch-mermaid blocks, patch-* note properties, and CSS customization names keep working. The Community build changes old Latest or Custom choices to Bundled. Simple Icons may still download icon data from jsDelivr; see the README for network use.
Installation
For a new installation:
- Download
main.js,manifest.json, andstyles.cssfrom this release's Assets. - Place the files in
<vault>/.obsidian/plugins/patches/. - Reload Obsidian and enable Patches under Settings → Community plugins.
Upgrading from Obsidian Patch? Follow the migration guide before creating a new patches directory. Close Obsidian completely before applying the migration, and keep the old and new plugins from being enabled together.
To use the Full build, check out this release's source and run npm ci followed by npm run build:full; install the three files from dist/full/. Both builds use the same ID, so installing a Community build replaces a Full build. Future Community Directory updates will do the same.
Patches is not yet listed in the Community Directory.
Verification
Both production builds and their release-package checks passed. The candidate passed 103 unit tests and 81 integration checks on macOS with Obsidian 1.15.1, covering Markdown-to-HTML conversion, Callout editing, and Mermaid rendering in both builds, including Cynefin, ELK, and theme changes.
Live jsDelivr requests and mobile platforms were not tested; remote-loading behavior has mocked unit coverage. PDF export, Math Format, Banner playback, and the broader table-editing suite were not rerun for this candidate. See the verification record and changelog.
Obsidian Patch 0.2.1 — Version metadata correction
This update corrects the version metadata in the 0.2.0 public preview. The plugin manifest, npm package, lockfile, and compatibility map now agree on 0.2.1.
Requires Obsidian 1.15.0 or later, matching the tested baseline. The plugin keeps the name Obsidian Patch and ID obsidian-patch; Mermaid loading and other features are unchanged.
Installation
- Download
main.js,manifest.json, andstyles.cssfrom this release's Assets. - Close Obsidian and place the three files in
<vault>/.obsidian/plugins/obsidian-patch/, preserving any existingdata.json. - Reopen Obsidian and enable Obsidian Patch under Settings → Community plugins if it is not already enabled.
The previously published 0.2.0 tag and attachments remain unchanged. This correction builds from the same feature code; its build and version consistency were checked. Testing has focused on macOS desktop.
See the changelog for details. The separate Patches 0.3.0 release changes the plugin ID and provides migration instructions.
Obsidian Patch 0.2.0 — Public preview
The first public preview of Obsidian Patch: focused fixes and enhancements developed from everyday use of Obsidian.
Highlights include:
- Newer Mermaid diagrams, including Cynefin, through
patch-mermaidblocks. - Visual HTML table editing and Markdown-to-HTML table conversion.
- Callout editing with live preview and GitHub compatibility tools.
- Heading bookmarks and same-note heading links in exported PDFs.
- Math formatting, note covers, explorer icons, and reading and editing improvements.
Installation
Requires Obsidian 1.13.7 or later.
- Download
main.js,manifest.json, andstyles.cssfrom this release’s Assets. - Place them in
<vault>/.obsidian/plugins/obsidian-patch/. - Reload Obsidian and enable Obsidian Patch under Settings → Community plugins.
Testing has focused on macOS desktop. PDF export uses Obsidian’s desktop export workflow. The plugin is not yet listed in the community directory.
See the [README](https://github.com/yaroxy/obsidian-patch#readme) for demonstrations and configuration. Feedback and bug reports are welcome through [GitHub Issues](https://github.com/yaroxy/obsidian-patch/issues).