Learn more

Changelog

Follow Obsidian updates and improvements.

Shiny new things

  • Updated installer to Electron 18.0.3 which fixes several bugs that were in Electron 17.
    • Fixed performance issues with resizing the app.
    • Fixed window border issues on Windows.
    • Fixed developer tools performance snapshot issues.

Improvements

  • When selecting text and converting into a fenced code block, newline characters are now automatically added.
  • The insert callout command will now wrap any selected text into the callout body content instead of replacing it.

No longer broken

  • Reduced lag caused by big exclusion filters with Obsidian Sync.
  • Fixed headings in lists causing indentation guides to misalign.
  • Fixed monospaced font not applied.

Shiny new things

  • Font settings can now list all fonts installed in the system (requires installer update to v0.14.4).
  • You can now assign multiple fonts to each font option, and the first available font will be used.

Improvements

  • Obsidian Sync should now no longer create duplicate files when renaming a file while it is still syncing.
  • Obsidian Sync now has a fully customizable sync folder exclusion system. This allows you to add exclusions to folders even if they don't exist locally.
  • Auto-completing three backticks for code blocks now adds a newline automatically to avoid suddenly parsing the rest of the note as code.
  • Toggle bold/italics will now smartly skip over the closing markers when at the end of the block, instead of adding more marker symbols.

No longer broken

  • Fixed on Linux the app doesn't properly watch for changes in the config folder.
  • Fixed headings in lists not properly styled in Live Preview.
  • Fixed duplicate event handlers for embeds, callouts, and tables blocks in Live Preview.
  • Fixed app crashes on startup for platforms that doesn't have a configured documents folder.
  • Fixed x-callback-url not properly taking into account existing ? query parameters.
  • Fixed move file dialog lags in vaults with lots of folders.
  • Fixed <webview> unable to open pages externally in the browser.
  • Fixed downloading or updating plugins without css causes one to appear with the contents "Not found".

Developers

  • CSS variables related to fonts have been renamed.
    • --default-font is now --font-default (but it will fallback to --default-font)
    • --interface-font is now --font-interface.
    • --editor-font is now --font-text and will cover both editing and reading.
  • There is now a --font-interface-theme and --font-text-theme dedicated for themes to set the fonts.
  • Each theme and snippet is now put into its own <style> tag to avoid issues with imports not working.
  • app is now officially available as a global variable.

Shiny new things

  • You can now move, rename or locate your vaults directly from the vault switcher.
  • There is now a new in-app help page with links to the online help docs, Discord, forum, as well as the sandbox vault.
  • The local help vault has been replaced with a sandbox vault.
  • You can now set the font for the interface and the editor directly under appearance settings. Note that some themes may override this font setting.

Improvements

  • Improved Live Preview clicking experience for callouts and embeds.
  • Improved <iframe> for some websites that disallows being iframed.
  • There's now a command to open context menu for the current cursor location.
  • Vim mode up/down now goes into rendered code blocks, embeds, callouts, or tables in Live Preview instead of skipping them.
  • Pasting and dropping images or media files that are already located in the vault will now link to it directly instead of duplicating the file.

No longer broken

  • Fixed Chinese IME on Windows causes selection issues when using punctuation characters.
  • Fixed multi-line block math in blockquotes not working in Live Preview.
  • Fixed clicking on checkbox in callouts not working in Live Preview.
  • Fixed unindent always keeps one extra space when use tabs is turned off.
  • Fixed Quick Switcher not respecting relative path for creating new files.
  • Fixed unable to select text within embeds in Live Preview.
  • Fixed memory leak when closing local graph view.
  • Fixed using the editor search or replace commands doesn't auto-fill selected text when search or replace is already open.
  • Fixed issue where the currently focused pane would lose focus when trying to focus a pane that can't be focused.
  • Fixed Audio Recorder's webm files can't be seeked and doesn't show total time.
  • Fixed pasting images on macOS is inconsistent between Firefox, Chrome and Safari.
  • Fixed folding not loading properly sometimes when using horizontal rules.

Developers

  • Callouts now has its metadata (the part in ![type|metadata]) put into its html as data-callout-metadata.
  • <webview> tags are now allowed to be used to embed external content for plugins (Electron/desktop app only).
  • Updated DOMPurify, Turndown, Mermaid, PIXI.js, and Prism.js.
  • Obsidian URI's new action now has an optional append flag and an optional overwrite flag. If append is set, it will append to an existing file if one is found. If override is set, it will overwrite an existing file if one is found, but only if append isn't set.
  • Obsidian URI's new and hook-get-address actions can now optionally accept x-success as part of the x-callback-url specifications, and will return a name, url, and file (file://) as the returned URL parameters.
  • Menu constructor no longer requires App to be passed in.

Core update

  • Includes all new functionality and bug fixes up to Obsidian Desktop v0.13.33.
  • Fixed large PDFs not rendering.

iOS

  • Fixed keyboard always dark in light mode.
  • Fixed sometimes the toolbar icons renders above the toolbar.
  • Fixed clicking on links while editing not working, allow tap and hold to edit a link.

Android

  • Fixed status bar always dark in light mode.
  • Fixed remote resources from http links not working.
  • Fixed file created/modified times being negative (shows up as year 1969) when using a 32-bit processor.

Core update

  • Includes all new functionality and bug fixes up to Obsidian Desktop v0.14.2.

iOS

  • You can now share text, links, image, and other attachments directly to the Obsidian app.

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.
Follow us
© 2024 Obsidian