Learn more

Changelog

Follow Obsidian updates and improvements.

Shiny new things

  • Starred files now support hover page preview.

No longer broken

  • Fixed consecutive tables in Live Preview are rendered together.
  • Fixed queries in callouts not working.

Shiny new things

  • Live Preview now supports basic Markdown tables previewing.

Improvements

  • Improved indenting/unindenting lists in blockquotes.

No longer broken

  • Fixed embeds in collapsed callout blocks aren't rendered properly.
  • Fixed embeds after a callout block not recognized in Live Preview.
  • Fixed math block spanning the whole line breaks out of the callout block.
  • Fixed callouts with a nested embed to its own file causes app to freeze.
  • Fixed callouts looks ugly in exported PDF when app is in dark mode.
  • Fixed folded callouts stay folded in exported PDF.
  • Fixed callouts disappear in Live Preview sometimes if another identical callout is present later in the page.
  • Fixed folding in Live Preview unfolds instantly if the text selection was placed in the folded block.
  • Fixed hover page preview on Markdown links not working.
  • Fixed copy code block button not showing in reading view.

Callouts

Obsidian Markdown now allows you to create callout blocks (sometimes called "admonitions"). Callouts are written as a blockquote, inspired by the "alert" syntax from Microsoft Docs.

A big shoutout to @javalent from the community for creating and maintaining the Admonitions plugin, from whom we've gotten a ton of help and inspiration!

For compatibility reasons, if you're also using the Admonitions plugin, you should update it to at least v8.0.0 to avoid problems with the new callout system.

Callouts will also be supported natively on Obsidian Publish.

See our documentation for more on how to use callouts.

Example:

> [!INFO]
> Here's a callout block.
> It supports **Markdown** and [[wikilinks]].

Indentation guides

Indentation guides (sometimes known as relationship lines) are now available in Live Preview and Reading view.

They can be turned off in editor settings.

Improvements

  • In Live Preview, fold icons will now only show up when hovering the same line as the fold indicator.
  • In Live Preview, you can now hold Ctrl/Cmd+Alt when clicking on links to edit them.
  • When right clicking links, there is now an option to open the link.
  • When right clicking links to a file that doesn't exist yet, there is now an option to create the file.
  • Improved Enter handling in blockquotes and lists.
  • Improved Live Preview rendering when switching between different blocks of embed/rendered code.
  • Tasks with checkmark characters other than x will now no longer have the strikethrough formatting applied.
  • Improved editor spacing to better align with Reading view.
  • When failing to save a file, Obsidian will attempt to save a copy in File Recovery.
  • Prevent accidentally renaming files to start with . causing it to disappear.

No longer broken

  • Fixed vaults on network drives don't load images properly.
  • Fixed block IDs with uppercase letters couldn't be linked properly.
  • Fixed scroll-sync between Live Preview and Reading view for large blocks and nested lists.
  • Fixed cycle bullet list/checklist command not working well when the line is indented.
  • Fixed Quick switcher sometimes opens the file in the wrong pane.
  • Fixed navigating to headings, blocks, or search results sometimes requires two clicks to work in dual-pane mode.
  • Fixed editor sometimes runs into an error while saving, but shows a notice about another file.
  • Fixed Audio recorder always inserts audio link at the end of the file, rather than where the cursor is.

Developers

  • Plugin inline sourcemaps are now stripped for performance unless the debug startup time option is enabled.
  • Fixed using position: relative on lists in reading mode causes scroll sync to be completely broken.
  • Indentation guides in the editor are styled using the CSS class cm-indent, and will gain cm-active-indent for the indent closest to the selected line.

No longer broken

  • Fixed wrong release built in 0.13.32.

No longer broken

  • Fixed typing with IME causes text duplication on Windows and Linux.
  • Fixed lag caused by file explorer in large vaults due to a Chromium bug.
  • Fixed Obsidian starts up with a blank window for a split second.

Shiny new things

  • Major engine upgrade from Electron 16 to 17. This version fixes issues with emoji rendering in Electron 16.

No longer broken

  • Fixed headings in legacy editor not properly sized.
  • Fixed unable to open help vault.
  • Fixed comment %% parsing regression in edit mode.
  • Fixed cursor jumps back with some IMEs in Live Preview.

Shiny new things

  • Major engine upgrade from Electron 13 to 16.
    • This will require downloading the latest installer from our website and installing over.
    • Updated macOS app icon.

No longer broken

  • Fixed pasting images from websites.
  • Fixed search and replace commands not working when search is already open.
  • Fixed search in reading view always override search hotkeys from another pane.

Improvements

  • Slightly improved typing performance in global search.
  • Ctrl+dropping to link external files from Finder on macOS no longer works due to a system limitation, and has been remapped to Option+drop.

No longer broken

  • Fixed sometimes hover previews show up empty.
  • Fixed embedding indented list items sometimes render as code.
  • Fixed pasting image files not working on macOS sometimes.
  • Fixed embedding list items with children using different list symbols (for example - vs *) not working.

Improvements

  • Enter on empty line now exits blockquotes again, and Shift+Enter has been improved to work as "soft line wrap" where it will smartly add indentation to keep you in the same list/blockquote but on the next line.

No longer broken

  • Fixed outgoing links unlinked mention section stopped working.
  • Fixed dollar signs in wikilinks parsed as math.

Shiny new things

  • Added new "Cycle bullet/checkbox" command that cycles between regular bullet, checkbox, and checked checkbox.

Improvements

  • Reduced chance of Obsidian Sync overwriting instead of merging when a rare race condition happens.
  • Improve Obsidian Sync's handling of templated daily notes created on other devices (will require next mobile release to fully apply).
  • Pressing Enter in an empty blockquote now extends the blockquote instead of exiting it. Shift+Enter can be used to exit the blockquote.

No longer broken

  • Fixed embeds in Live Preview blocks have an extra padding at the bottom.
  • Fixed using many embeds and images in Live Preview sometimes causes click position detection to misbehave.
  • Fixed outgoing links crash when encountering a link named "constructor".
  • Fixed middle click in editor doesn't open in new pane.
  • Fixed drag and drop in outline pane not working when pane is scrolled.
  • Fixed LaTeX and inline code not properly sized in headings.
  • Fixed Live Preview HTML blocks not respecting normal HTML white-spacing rules and rendering extra whitespace by default, causing newline characters to be rendered.
  • Fixed Ctrl/Cmd+G stopped working in document search.
  • Fixed various Markdown syntax toggle commands like bold and italics misbehaving when working across multiple lines.
  • Fixed multiple possible memory leak in editor when closing panes.
  • Fixed a bug in list block ID parsing which caused links and embeds to resolve the parent list item instead of the specific child item.
  • Fixed sometimes the context menu appears multiple times on screen.
  • Fixed unable to see last few characters of long tables in legacy editor.
  • Triple clicking text will now select the whole sentence without the ending newline character.

Developers

  • Theme developers: you can also now use variables for heading font sizes with --h1, --h2, etc. We've also moved heading font sizes from cm-header-x to HyperMD-header-x to avoid certain elements not being properly up-sized like LaTeX and inline code.
  • There is a new deleted event on MetadataCache now.
  • DataAdapter.stat now returns the OS mtime and ctime for folders.
  • Obsidian's icon library now supports all icons from lucide, a currently maintained fork of feather-icons with 547 supported icons. No need to import feather-icons anymore. You can browse them at Lucide.dev

Core update

Includes all new functionality and bug fixes up to Obsidian Desktop v0.13.24. This update also allows all new cm6-compatible plugins to run.

Live Preview While this feature works pretty well already, it hasn't been fully mobile optimized, so there could still be some usability issues when using with a touch-only device, such as editing embeds and code blocks. In the meantime, feel free to use Source Mode when that happens. You can do that by long-holding the 3 dot button on the top right and hitting "Toggle Live Preview/Source mode" (or run a command from the pull down menu or bottom toolbar).

Vim mode Support for vim mode is now available, but must be enabled on a per-device basis on mobile. It is not really usable on a mobile device without an external keyboard.

Others Drag and drop features from desktop is now generally available across the app, and can be triggered by long-holding items. This includes drag and drop files and folders, starred items, and outline items.

No longer broken

  • Fixed several themes broken due to the new <img> placeholders.
  • Fixed reading view images without width/height gaining a null width/height attribute when the paragraph is edited.

Shiny new things

  • Clicking on links in Live Preview will now open them directly.
    • Previously Ctrl/Cmd+Click to open link is now simply a click.
    • Previously Ctrl/Cmd+Shift+Click to open link in new pane is now Ctrl/Cmd+Click, just like everywhere else in the app.
  • Embedding list items will now show any sub list items when rendering.

Improvements

  • Embeds to files that don't yet exist will automatically load the file once it's created. This avoids issues with images that syncs in after opening the note it was embedded in.
  • Word count now properly counts apostrophes.
  • Renamed "Swap line up/down" commands to "Move line up/down".
  • Obsidian Publish now has an option to hide page title headings.
  • Added persistent notice to the help vault to remind users not to save data in it, since the help vault can be reset.
  • Added additional confirmation for opening file:/// links.

No longer broken

  • Fixed several issues with IME in the new editor.
  • Fixed code blocks tagged with markdown as the language causes Live Preview to misbehave.
  • Fixed mermaid state diagrams not properly sized.
  • Fixed command palette performance issue.
  • Fixed export to PDF doesn't expand embedded notes and instead show a scrollbar.
  • Fixed local file:/// links stopped working.
  • Fixed macOS caret character misbehaving when used as a deadkey in some keyboard layouts.
  • Fixed hitting Shift+End twice not going to the end of the paragraph.

Developers

  • Theme developers: our new editor has received an upgrade where previous &ZeroWidthSpace; characters, used as placeholders for computing cursor positions, have been switched to 0-width <img> elements. We recommend double-checking that your theme does not contain global img { ... } CSS rules to avoid breaking the editor.
  • TFile.unsafeCachedData has been removed and is now stored in a private inaccessible WeakMap to avoid accidental use of this unsafe data.
  • There is now a new requestUrl API function that returns an object with the http response status, headers, as well as getters for arrayBuffer, json, and text. This is a more advanced version of the request API. (Requires API version 0.13.25)
  • The request and the new requestUrl functions can now accept a body of type ArrayBuffer.

Improvements

  • Reduced the chances of Obsidian Sync duplicating the contents of a note when it encounters a conflicting new note which is modified both locally and remotely. It will now keep the latest version when this happens. (This patch is only fully effective when all of your devices are upgraded to this version)
  • Slightly improved editor performance.

No longer broken

  • Fixed editing large documents causes embeds to be broken.
  • Fixed indented code blocks adds large gap sometimes.
  • Fixed heading fold broken when multiple space characters are used after #.
  • Fixed plugins unable to load when using esbuild's new esmodule format.
  • Fixed toggling checklists only adds list bullet when no lists exist.

No longer broken

  • Fixed external URLs with % encodings stopped working but wasn't fully fixed last release.
  • Fixed renaming files with $ signs sometimes causes links to be generated incorrectly.
  • Fixed link suggestion crashes when using Markdown links.
  • Fixed link suggestion showing "no results found" when only one exact match found.

No longer broken

  • Fixed external URLs with % encodings stopped working.
  • Fixed external URLs in embed blocks not working in Live Preview.
  • Fixed line numbers misaligned with embed blocks in Live Preview.
  • Fixed list bullets misaligned vertically in Live Preview.
  • Fixed a case of Live Preview lag when large base64-encoded images are inserted.
  • Fixed sometimes a zero width space character is inserted when replacing some text around fold indicators. They showed up as a red dot.
  • Fixed sometimes choosing a link suggestion to a block without an ID in the same document causes the cursor to be misplaced.
  • Fixed up/down keys misbehaving in Live Preview's word-wrapped lines when the previous/next real line is a hidden block.
  • Updating plugins no longer scrolls the plugin list back to the top.

Developers

  • Added an option in community plugin pane to help debug slow plugin startup times.
  • Fixed editorLivePreviewField not dynamically updated when Live preview is turned on/off.
  • Added data-type to tab header elements.

No longer broken

  • Fixed legacy editor crashes when using frontmatter.
  • Fixed Ctrl/Cmd+G hotkey doesn't work in reading mode.
  • Fixed Ctrl/Cmd+G does not override open graph view command.

Developers

  • Introduced apiVersion: string and requireApiVersion(version: string): boolean to help with API version requirements. Plugin authors can use this function to limit functionality that depends on new Obsidian APIs to avoid crashing on older versions of Obsidian.

Improvements

  • The new editor now supports the cssclass frontmatter property.
  • Live Preview will now detect whether the editor is focused to apply syntax hiding.
  • Community plugin search filter will now also match by author.
  • Added shortcuts for plugin settings and hotkeys in the community plugins list.

No longer broken

  • Fixed clicking on checklists and fold indicators causes the cursor/selection to be affected.
  • Fixed resizing panes causes buggy selection rendering until selection is changed.
  • Fixed fold indicator spacing sometimes misalign due to fonts applied by themes.
  • Fixed gutter line numbers not showing for embeds and custom code blocks.
  • Fixed memory leak when closing Markdown panes.
  • Fixed vim mode undo/redo combines multiple edits.
  • Fixed up/down arrow keys don't navigate properly around list bullets.
  • Fixed up/down arrow keys don't navigate properly when at the end of a word-wrapped line.
  • Fixed unindenting numbered lists sometimes generates "undefined".
  • Fixed auto number lists generates individual undo/redo entries for each line.
  • Fixed toggle numbered lists always generate 1 as the number.
  • Fixed typing inline code causes the rest of the document to become code.
  • Fixed underline not applied to external links when in lists, headings, or blockquotes.
  • Fixed two identical embed in the same file causes Live Preview to misbehave.
  • Fixed linking to a block without a block id from an earlier position in the same note causes the link to be badly formatted.
  • Fixed in-editor search removes highlight when only a single match is found.
  • Added Ctrl/Cmd+G (and Ctrl/Cmd+Shift+G) for selecting next/previous search occurrence when using in-editor search.
  • Fixed opening some file:/// paths on Linux causes Obsidian to freeze until the new process exits.
  • Fixed Markdown importer unable to convert tags with some character sets like CJK characters.
  • Fixed undo close pane still opens a new pane even when the current pane is empty.
  • Fixed copy external URL menu action doesn't properly encode special characters.
  • Fixed linking an unlinked mention loses its original casing.

Developers

  • Fixed sometimes empty duplicate <span> elements show up before or after widgets, causing issues when using css padding or :before/:after.
  • The debug info command now includes the OS information.
  • There is now a new editorLivePreviewField: StateField<boolean> that can be used to check whether Live Preview is enabled in the editor.
  • Fixed out-of-bound {line,ch} pairs causes error with new editor.

No longer broken

  • Fixed automatic numbering of lists doesn't stop at the end of the list and accidentally changes the numbers of lists further down the document.
  • Fixed sometimes undo/redo combines multiple consecutive operations like typing and pasting into a single change.
  • Fixed when redoing a change, the cursor would be put in the wrong spot afterwards.
  • Fixed sometimes bad HTML causes Live Preview to crash with an error.

Improvements

  • Improved fold indicators in new editor. They will now appear closer to the line's text rather than all the way at the left edge.
  • New hotkeys for in document search: "Search All" (Alt+Enter) and "Replace All" (Ctrl/Cmd+Alt+Enter).
  • In Live Preview, you can now click a code block's language flair (top right) to copy the code block.
  • New editor's vim mode now experimentally supports search highlighting and multiple cursors.
  • You can now use Ctrl/Cmd+Shift+Enter in quick switcher to create a new note and open it in a new pane.

No longer broken

  • Fixed the fold all command sometimes not working.
  • Fixed Shift+Up/Down in Live Preview doesn't select hidden blocks properly.
  • Fixed backlink and unlinked reference count indicator not properly updated when a link is removed.
  • Fixed middle click and Ctrl/Cmd+Click embedded note's "open link" button in Live Preview causes weird behavior.
  • Fixed middle click links, file explorer items, and search results stopped working.
  • Fixed unable to click external links with formatting styles like bold or italics in editing view.
  • Fixed sometimes the bullet dot renders as weird letters.
  • Fixed console error when OS language doesn't support spellchecker.
  • Word count now properly count contractions as one word.

Developers

  • Added .cm-active to gutter elements as well.