Obsidian Release Notes

Includes all new features and bug fixes up to Obsidian Desktop v1.13.1.

Improvements

Settings pages now have enough padding to scroll fully into view when the onscreen keyboard is showing.

No longer broken

iOS: Fixed app crashing when sharing screenshots via the Share Sheet.

Live Preview: Fixed "Enter" from the iOS keyboard not working as expected inside Markdown lists.

Original source

Improvements

Settings

Sliders now show a permanent label with the current value, shown inline next to the slider instead of in a tooltip.

Searching within a settings group now automatically filters the items in that group.

Navigating back now restores focus to the setting item you came from.

Added support for the mouse "back" button to navigate back through settings history.

Added Alt-ArrowUp and Alt-ArrowDown to reorder items inside setting lists.

The command palette settings tab now uses the standard settings rendering.

Improved the layout of the community plugins list.

Deprecated the Settings Search plugin as it overlaps with the new search functionality. Thank you to javalent for such a great plugin! It has been added to the Obsidian credits page.

Other

Mermaid diagrams now render immediately after you allow them in a vault, without needing to reload.

No longer broken

Fixed setting pages not always loading when navigating to them from setting search results.

Fixed the placeholder text shown in the command palette prompt.

Fixed choppy horizontal scrolling when sidebar tabs overflow.

Live Preview: Fixed embeds inside Markdown lists not showing the correct indentation.

Live Preview: Code blocks now re-render correctly when a plugin's post processor changes.

Bookmarks: Fixed focus not moving to the next item after deleting a bookmark with Cmd-Backspace.

Bookmarks: Fixed Cmd-Backspace not clearing the filter input.

App: Fixed app silently crashing on any installer older than Obsidian 1.6. We've also added an error message if this ever happens again.

Desktop: Fixed navigation inside embedded web content (webview).

macOS

Fixed some elements showing scrollbars when they should not, such as the tab headers in the sidebars.

Developers

Settings: Added a reset button next to all setting definitions using "slider" or "color" controls.

Settings: Added a new display label to surface values before opening a settings page.

Fixed SettingDefinitionGroup#cls silently failing when trying to provide multiple classnames.

Upgraded CodeMirror to the latest version.

Original source

Includes all new features and bug fixes up to Obsidian Desktop v1.13.0.

New

iOS: New Share Sheet with configurable Locations. Configure Locations to point to different destinations across any of your vaults.

iOS: Share Sheet now supports copying the full content of web pages, and content from other apps such as YouTube and social networks.

Tabs can now be reordered from the tab switcher. Swipe to close the tab

Tablet: Press-and-hold to resize splits and pinned sidebars.

Bases: New menu item to resize columns in table views.

No longer broken

iOS: Fixed "Delete file" not updating the app interface on non-English devices.

iOS: Fixed setting pages scrolling back to the top after changing setting values.

Fixed a bug where the input field in the Search view would sometimes autofocus when you open the sidebar.

Developers

We have increased the minimum iOS version from iOS 14.5 to iOS 15. This should not impact any supported devices.

Original source

This release introduces a revamped Settings panel that opens in a new window with built-in search and keyboard navigation.

New

Settings now open in a new window. You can turn this off in Settings → Interface.

Added search. You can now search for settings by name or description. This currently supports core settings and core plugins. Community plugins can migrate to the new settings API to appear in search results.

Added keyboard navigation. Use arrow keys to move between items, Enter to open a setting tab, and Ctrl/Cmd-F to re-focus search. Also supports Vim key bindings.

Some settings have moved into the a new Interface settings page. Several settings pages have been redesigned to improve navigation.

Added the ability to exit Restricted Mode without re-enabling your plugins. Useful for debugging your vault.

Security

Obsidian URIs now present a confirmation dialog before firing the action. Choose "Don't ask again" to add that action to an allow list. Manage the allow list from settings.

Added a warning before attempting to load HTML resources if the source points to a network drive.

Added a warning dialog when choosing to sync plugins via Obsidian Sync.

Other

Added search to Bookmarks view.

Added a new one-time banner confirming that you want to render Mermaid code blocks in your vault.

On desktop, dragging a folder into the app now imports the entire folder and preserves the directory structure.

Improvements

Ctrl-N and Ctrl-P to navigate to the next/previous item in suggestions now work on all platforms.

Updated the dialog that appears when opening an unrecognized vault with plugins installed. Wording has been improved to emphasize the risk of using untrusted plugins.

Editor

Live Preview: New editor experience when working with images. Images can now be selected via the keyboard, and they don't automatically expand to reveal their filename. When the image is selected, backspace and delete will delete the image, and Ctrl/Cmd-C/Ctrl/Cmd-X will copy or cut the image. This should also support Vim out of the box.

Note Composer: When extracting a section from a file, links in that section will now be rewritten to be relative to the new location.

File explorer

Pressing "Escape" to cancel the file rename keeps the File Explorer focused.

Pressing "Escape" clears the current selection.

"Auto reveal" will no longer activate when renaming a file or folder.

Minor improvements to drag and drop behavior.

Properties

Improved keyboard navigation in Global Properties view, Backspace now deletes the selected properties.

Property menu differentiates when a property has an automatic type assignment or not.

Obsidian Sync

Removed spinning from the status bar icon because it impacted battery life when the app idles.

Files in the Sync view now show all file-related items in the context menu.

Files in the Sync sidebar view can now be dragged into other views or into the editor.

Added search menu item to the Sync sidebar view.

macOS

Updated button and input styles to better match macOS 26 defaults.

Canvas

Minor rendering performance improvements.

Other

Closing the quick switcher or command palette with the escape key now correctly restores previous selection.

Pressing Escape key now hides the search input in sidebar views.

Disabling a snippet will remove the snippet from all pop-out windows.

No longer broken

Fixed clicking external links in pop-out windows causing the pop-out window to close.

Fixed ribbon buttons not responding to touch events on desktop.

Fixed CSS snippets staying applied to pop-out windows after disabling them.

File Explorer: Fixed rare bug where files temporarily rendered with the wrong indentation level after moving the file to a new folder.

Live Preview: Fixed Ctrl/Cmd-A not working inside embedded inputs (e.g. a cell in an embedded Bases table).

Properties: Fixed Global properties view not always saving sort order.

Properties: Fixed "Delete properties" menu item not working reliably when property name contains capital letters.

Properties: Fixed "Open link under cursor" hotkeys not working on list property items.

Bases: Fixed error messages appearing when disabling and re-enabling the Bases core plugin.

Bases: Fixed automatic column sizing for number properties.

Developers

Documentation and Migration guide for the new Settings API.

Added a new ConfirmationModal component.

Codemirror has been upgraded.

Base colors have been migrated to OKLCH colorspace.

--callout color variable now expects a valid CSS color. This is a breaking change:

/* Previously callout colors expected an RGB triplet. */
--callout-color: 255,0,0;
/* Now any valid CSS color is valid */
--callout-color: #ff0000;
--callout-color: rgb(255,0,0);

CLI

Fixed Obsidian CLI for flatpak installs.

Third-party Libraries

Upgraded Moment.js to 2.30.1.

Upgraded Mermaid to 11.13.0.

Original source

No longer broken

Fixed language selector not allowing you to choose "English" if the device language is not English.

CLI: If the vault parameter is included, it must be the first argument.

Attempting to open a second instance of the app (e.g. from the Windows task bar) will now open the vault starter again.

Live Preview: Fixed SVGs not rendering.

The daily:prepend CLI command now inserts content after the frontmatter instead of at the very beginning of the file.

Original source

Improved

Secret Storage is now encrypted while on disk. This relies on encryption provided by your operating system. For Linux users, this requires that kwallet, kwallet5, kwallet6 or gnome-libsecret are installed.

Daily notes: Folder path is now normalized.

Daily notes: If you were previously using the "Open daily note on startup" option, you will be automatically migrated to use the new "Files & Links › Default file to open" setting.

No longer broken

Fixed Default file to open not working when the configured file path omits the file extension.

Fixed daily notes not opening if the path began with a leading / or used \ as a path delimiter.

Restored default display text when inserting a link with folders in the linktext (e.g. [[a/b/file]] will automatically be inserted as [[a/b/file|file]]).

Developers

The CSS variables --blur-translucency-s and --blur-translucency-m have been renamed to --blur-opacity-s and --blur-opacity-m.

Original source

Improvements

Obsidian CLI

The Obsidian Installer is now bundled with a new binary file for using the CLI. This new method replaces the old method of calling the Electron binary, resulting in significantly faster terminal interactions. Requires downloading the latest installer.

Added autocompletion for Obsidian commands to the terminal interface (TUI) when using the id= parameter.

Bug fixes

Obsidian CLI

Fixed the Obsidian CLI incorrectly checking for a Linux-specific directory on macOS.

Changed the CLI socket file to a hidden dotfile on macOS and Linux.

Editor

Fixed several issues with copy, cut, and paste when no text is selected.

Copying and pasting a line no longer places the cursor in the wrong position.

In tables, copying or cutting without a selection now correctly copies only the cell contents.

Pasting a URL while text is selected across multiple cursors now wraps each selection as a Markdown link (selected text).

Fixed images inside callouts showing unwanted scrollbars in Reading mode.

Fixed double-clicking an image in Live Preview not resetting its size.

Developer

The installer has been updated to use Electron v39.8.3 (requires downloading the latest installer).

Original source

Bug fixes

CLI

Fixed the Obsidian CLI incorrectly checking for a Linux-specific directory on macOS.

Changed the CLI socket file to a hidden dotfile on macOS and Linux.

Editor

Fixed some regressions with the editor introduced in 1.12.4.

Fixed images inside callouts showing unwanted scrollbars in Reading mode.

Fixed double-clicking an image in Live Preview not resetting its size.

Original source

Includes all new features and bug fixes up to Obsidian Desktop v1.12.7.

Original source

Improvements

Obsidian CLI

• Added autocompletion for Obsidian commands to the terminal interface (TUI) when using the id= parameter.

Bug fixes

• Fixed several issues with copy, cut, and paste when no text is selected.
• Copying and pasting a line no longer places the cursor in the wrong position.
• In tables, copying or cutting without a selection now correctly copies only the cell contents.
• Pasting a URL while text is selected across multiple cursors now wraps each selection as a Markdown link (selected text).

Original source

Obsidian Sync now supports headless operation using the obsidian-headless client. Learn more about how use Obsidian Headless with Sync.

Original source

Includes all new features and bug fixes up to Obsidian Desktop v1.12.4.

New

• iOS: New Share extension to save content to your vault from other apps (e.g. Safari, social networks) without opening Obsidian.
• iOS: New Shortcut action "Bookmark Link" to save URLs as Obsidian bookmarks.

Improvements

• The app now defaults to the system language and includes a language picker during onboarding.
• Added new "Unique note" App action (the menu when you press and hold on the app icon).
• Improved support for pointer devices on tablet (e.g. Magic Trackpad):
  • Submenus now expand on hover.
  • Property editor context menu shows on right-click.

No longer broken

• Removed the "Delete and do not ask again" option from the file deletion prompt.
• Obsidian Sync: Fixed an issue where files would get overridden if the app is closed before Obsidian can save the latest Sync state.
• iOS: Fixed tooltips sometimes appearing after interacting with items in the sidebar.
• iOS: Fixed issue causing the Daily Note and Bookmark Shortcuts to not work.
• iOS: Fixed issue causing View Note widget to not refresh immediately.
• Slides: Fixed the close button position in the status bar on mobile.

Original source

New

Obsidian CLI

This release introduces the Obsidian CLI, a command line interface that lets you control Obsidian from your terminal for scripting, automation, and integration with external tools.
For installation help, check the troubleshooting section for the platform-specific information.

Image resizing

Images in Live Preview can now be resized by dragging from the corner. Double-click the corner to reset the image size.

Automatic attachment cleanup

When deleting a file, a prompt will ask if you would also like to delete its attachments. A new setting in Files & Links allows you to configure this behavior (choose "Always", "Ask every time", or "Never").

Improvements

Bases

• Added a search toolbar button to filter query results.
• Added the ability to import files into Bases via drag and drop.
• Right-clicking on a single row in table view now shows context menu items related to that file.

File Explorer

• Copy and paste operations are now supported using Ctrl-C/Ctrl-V (Cmd-C/Cmd-V on macOS).

Editor

• Added new menu items when you right-click in the empty space next to the editor:
  • Toggle line numbers
  • Toggle inline title
• Fixed missing space after blockquotes.
• Fixed styling of bold links.
• Image size is no longer treated as display text when dragging a link.

Other

• Added detection for backlinks in Canvas files. They now appear in the Backlinks view, and count as links in the Graph view.
• "Change vault..." has been renamed to "Manage vaults".
• Added a new "Change vault..." command to quickly switch between vaults via the keyboard.
• Added a new "Open vault..." command to open an existing vault via the keyboard and keep the current vault open.
• Alt-clicking a file in the File Explorer now adds the previous active item to the selection.
• Quick switcher: Dragging results is now supported.
• Added new "Copy image" menu item when right-clicking on an image.
• Copying text from the editor now includes HTML formatting, making it easier to paste into apps like Google Docs.
• Obsidian Sync now logs when files were skipped for being too large.
• Improved fuzzy search results when the query contains spaces.
• Opening files in an external application now shows a confirmation dialog for added safety.
• Added a warning when attempting to open an executable file.
• Added new app translations.

No longer broken

Other

• Keychain: Added handling for when encryption is unavailable on some Linux machines.
• Fixed issue where layout was not always saved when the app is closed.
• Fixed issue where selecting text near a link or tag would incorrectly trigger the link or tag token.
• Fixed issue where closing a pop-out window with active notices would cause them to move to the main window and never disappear.
• Added a new unique URI action.
• Fixed the outline view flickering while typing.
• Fixed scroll position not updating after changing the row height in Bases table view.
• Fixed "More options" menu not closing when clicking the "..." button in a pop-out window.
• Fixed list properties not showing edit and remove options in the context menu when right-clicking a link inside a list item.
• File Explorer: Fixed "Duplicate" menu item generating an incomplete folder name when duplicating a folder that includes "." in the name.

Developers

We've updated how our translation files are created and bundled with the app. For translators, see the updated instructions on our translations repository.
Added theming support for corner shapes using corner-shape CSS property. Replaced -electron-corner-smoothing. Requires Chromium 139 and Obsidian 1.11+.
macOS: New traffic-lights-offset-x and --traffic-lights-offset-y CSS variables to configure where the traffic lights appear in the window frame. These offsets are now applied immediately when the app loads.
We've introduced a breaking API change to BaseOption#shouldHide. This function no longer receives the config as an argument. Options should be accessed from BasesViewRegistration.options instead.

registerView('my-view-id', {
 name: 'View Name',
 icon: 'my-icon',
 factory: () => new MyView(),
 options: (config: BasesViewConfig) => ({
// Here ^
})
});

Added appendBinary method to the vault and adapter API.

Original source

Release notes

• Includes all new features and bug fixes up to Obsidian Desktop v1.12.4.
• No longer broken
• Slides: Fixed the close button position in the status bar on mobile.

Original source

No longer broken

CLI

Fixed the CLI not being detected correctly on Windows (introduced in Obsidian 1.12.3).

Added a warning message when the CLI is run from an outdated installer.

Windows

Fixed a bug with opening external links containing an encoded backslash character (%5C).

Original source