Changelog

No longer broken

• Linux: fixed bug causing Obsidian to not boot.

No longer broken

• macOS: Double-clicking the tab bar now maximizes the window in frameless mode.
• Linux: "Adapt to system theme" now works properly.
• The keyboard shortcut for rectangular selection has changed. Now alt-click will add multiple cursors while alt-shift-drag will create a rectangular selection.
• Theme dropdown properly refreshes when changing the theme in settings.
• Update buttons properly refresh after updating the plugin via the plugin modal.
• Removed duplicate drag element that appeared when dragging tabs.
• Fixed checkboxes not being selectable in Live Preview.
• Fixed selections from multiple cursors not appearing.
• Fixed bug where the wrong file could get renamed if you switch files mid-rename.
• Vim: Fixed gj and gk not working.
• Fixed empty lists getting collapsed in reading mode.
• macOS: spellcheck now properly replaces word even when no text is selected.
• The root folder in the File Explorer is no longer collapsible via the keyboard.
• Editor commands no longer trigger if the inline title is focused.
• Fixed alt-clicking multiple selections not behaving correctly.
• Fixed opening vaults via obsidian://vault not properly marking other vaults as closed.
• webm embeds are now properly recognized as video instead of audio.
• Fixed long suggestion titles not wrapping properly.
• Added missing search icon to graph view.
• Unique note creator: app no longer freezes when attempting to generate an invalid format.
• Graph View: dragging a node is now canceled when you start panning the canvas.

Developers

• Clicking on gutter elements now properly fires click events.

Improvements

• Misc. visual improvements for settings.
• Larger font sizes and better contrast for sidebar items.

No longer broken

• Mobile drawers can no longer be pinned on mobile.
• iOS: fixed issue where app would freeze when clicking backlinks.
• Tablet: The toggle button for the left sidebar is now visible again.
• iOS: fixed bug preventing cursor from selecting links in Live Preview.
• Fixed "Edit link" context menu item not selecting text.

Before you dive in

We've made some big changes both visually and under the hood for this release. If you rely on any third party plugins or themes, we highly encourage you to check for updates before delving into Obsidian 1.0.

• Settings → Appearance → Check for Updates.
• Settings → Community plugins → Check for Updates.

This update includes significant changes to the look and feel of Obsidian. Some of the highlights include:

• Tabs – The workspace now supports tabs. To accommodate tabs, we've made a lot of tweaks to Obsidian behaviors.
• Tab stacks – an alternative way to view your tabs, reminiscent of Andy Matuschak's website.
• New appearance settings – Obsidian has gone through an extensive redesign process to make the interface more robust, accessible, and easier to tinker with.
• Tons of other misc. improvements – New 'fold' commands, an overhauled Theme Gallery, and bug fixes galore!

Make sure to take a look at the FAQ section which should address some common points of confusion as you adapt to the new Obsidian.

Tabs

With this update, we have embraced tabs throughout the UI. We've found that tabs provide a more intuitive experience for both browsing and editing notes in your vault.

Tabs have had us rethinking some of the most basic interactions with Obsidian. We have taken this opportunity to consolidate the hotkeys for opening files. Combine these modifier keys when clicking on any link in Obsidian (this includes the quick switcher!) or use them with Enter to navigate the link under the cursor.

Tabs have also inspired some changes to how users browse their vaults. It felt only natural that we also introduce per-tab history. Each tab now maintains its own history for navigation.

Tab stacks

You can now switch any tab group in your workspace into a tab stack. Tab stacks provide an alternative way to view your tabs, reminiscent of Andy's Mode.

Tab stacks are, at their heart, the same as a tab group. Try mixing and matching with a tab group on one side and a tab stack on the other.

New appearance settings

We've introduced quite a few new settings at Settings → Appearance.

Additional improvements

• The Theme Gallery has gotten a major overhaul. Themes now support versioning just like plugins. Note: Themes that are not compatible with 1.0 have been marked as "legacy" and cannot be installed until they get updated.
• Added "collapse all" button to file explorer and tag view.
• Added "Fold more" and "Fold less" commands for folding lines under the cursor.
• Added "Change theme" command for quickly switching between themes.
• Auto-generated links to headings now keep more punctuation characters for better contexts.
• Added "Find & Replace," Export PDF, Share, and text formatting items to macOS app menu.
• Added Shift + Up/Down hotkeys to expand search results while a search item is focused.
• Renamed "Split vertically" and "Split horizontally" to "Split right" and "Split down" to avoid ambiguity.
• Pressing Home will now move the cursor to the beginning of a list item.
• Obsidian Sync: The history view has a toggle to choose between seeing the version of a file at a point in time or seeing the diff.
• Release notes will now automatically show after Obsidian updates.
• Improved community theme/plugin README.md relative images, added support for videos.
• Renamed "active file" to "current file" in several commands for better consistency.
• Improved the overall appearance of the app when "translucent window" is enabled.
• Soft-wrapping of lines should now better avoid misaligned indents.
• Added an option to Export to PDF to show the name of the note at the beginning of the document.
• Publish: "new" and "unchanged" sections are now collapsed by default.
• Fixed bug with search results containing "path:" sometimes showing duplicate text.
• Fixed multi-line embedded queries not working.
• Fix memory leak with loading native system fonts.
• Fixed crash when file explorer is missing a sort order.
• Ctrl/Cmd+W can now close the vault switcher and help window.
• File explorer keyboard navigation properly ignores hidden files.
• Clicking to edit Live Preview widgets (e.g. tables or callouts) will now scroll the view to the beginning of the widget.
• Word count now works for any text file that can be opened, not just md files.
• macOS: "obsidian" will now be capitalized in the App menu.
• macOS: commands will no longer refer to Finder as "System Explorer."
• macOS: right-clicking on top of the cursor will no longer cause the word under the cursor to be selected.
• Added show-theme action to the Obsidian URI. It will open the given theme in the Community theme gallery. For example: obsidian://show-theme?name=Minimal

For Developers

• Workspace information is no longer saved to the .obsidian/workspace file. It is now saved to workspace.json.
• Added standard color picker component.
• Added has-active-menu class to file explorer item that received the right-click.
• Added list-bullet class to HTML markup for unordered list items.
• Theme developers: we have published a guide for helping get your theme ready for 1.0.

FAQ

Q. Why am I seeing the title of my note duplicated at the top of my note?

We now display the filename as an Inline Title to allow filenames to feel more attached to the note. If you already have the heading of your note matching the filename, you might notice some redundancy. You can disable this feature via Appearance → Show inline title.

Q. Why does everything look so big/small?

The new update has made some changes to make Obsidian feel more native to your operating system. To adjust the overall scale of the UI, you can configure the UI Zoom level in Settings at Appearance → Advanced → Zoom level.

Q. How do I open notes side-by-side now?

The behavior of Cmd/Ctrl + Enter and Cmd/Ctrl + Click have changed to opening links in a new tab. To open links in a new pane to the right, you can use Cmd/Ctrl + Alt + Enter or Cmd/Ctrl + Alt + Click.

Q. Why can't I toggle checkboxes with CtrlEnter (or ⌘Enter on MacOS) anymore?

The default hotkey for "Toggle checkbox status" has been changed to CtrlL (or ⌘L on MacOS). CtrlEnter is now the default hotkey for opening links under the cursor in a new tab. You can change these hotkeys in settings.

No longer broken

• Fixed lag when switching tabs on larger files.
• Fixed not being able to scroll within plugin details page.

No longer broken

• "Save File" command now works with all text files, not just Markdown files.
• Fixed styling of nested block quotes in live preview.
• Fixed scroll getting reset when rearranging tabs.
• Fixed bug where inline document backlinks would sometimes render with a long scrollbar.
• Live Preview: Fixed bare emails not showing as links when appearing the middle of a line.
• Mermaid: improved rendering.

Shiny new things

• Introducing per-tab history. Each tab now maintains its own history stack for navigation.

A huge thank you to @pjeby for Pane Relief and for all his help with testing the new per-tab history!

Improvements

• "Show tab title bar" is now enabled by default. The tab title bar now also includes forward/backward navigation arrows as well as the full file path.
• Soft-wrapping of lines should now better avoid misaligned indents.
• Sliding Panes plugin will now automatically be disabled on startup.
• Added an option to Export to PDF to show the name of the note at the beginning of the document.
• Improved sidebar collapse/expand animation.
• Publish: "new" and "unchanged" sections are now collapsed by default.

No longer broken

• Legacy themes are no longer deleted when updating to 0.16 compatible themes. This should improve compatibility when syncing to a device that's not yet 0.16 compatible.
• Fixed pasting into inline titles inside pop-out windows.
• Fixed selecting text inside the Release Notes callouts.
• Pressing 'escape' will no longer cause the editor to lose focus.
• macOS: Command-ArrowLeft will now take you to the beginning of the current list item.
• macOS: Fixed "Show context menu" command not working with spelling corrections.
• Publish: fixed "use live version" not working with locally deleted files.
• Translucency is now disabled in fullscreen mode.

Shiny new things

• Introducing Tab Stacks. You can now switch any tab group in your workspace into a tab stack. Tab stacks provide an alternative way to view your tabs, reminiscent of Andy Matuschak's website.

Improvements

• Improved the overall appearance of the app when "translucent window" is enabled.
• The quick switcher will no longer attempt to reuse an existing tab when opening a file.

No longer broken

• Windows: fixed not being able to drag the window when a modal is open.
• Fixed styling issues in the Release Notes view.
• Theme modal will now show legacy themes that you have installed locally.
• Fixed "backlink in document" buttons not working.
• Outline view will only scroll the associated tab instead of all tabs with the same file.

Improvements

• The setting Appearance → Show view header has been renamed to Appearance → Show tab title bar.
• The setting Appearance → Title bar style has been renamed to Appearance → Window frame style.
• Added "UI zoom level" slider to Settings → Appearance.
• Release notes will now automatically show after Obsidian updates.
• Improved community theme/plugin README.md relative images, added support for videos.
• Added default hotkey for opening link in new window (Ctrl/Cmd+Alt+Shift+Enter)
• Improved performance for installing/updating plugins.
• Reduced flashing when searching for plugins.
• Renamed "active file" to "current file" in several commands for better consistency.

No longer broken

• Fixed quick switcher's "open to the right" hotkey not working.
• Fixed "Backlink in document" not always updating.
• Fixed file explorer not always highlighting selected files.
• Tweaked sizing and positioning of title bar when zoomed in/out.
• Obsidian Sync will now avoid deleting old themes.
• Fixed misaligned logo in custom mode.
• Fixed status bar jitter when word count updates.
• macOS: Tweaked location of traffic lights when zoomed in/out.

Note about custom themes

Major changes have been made to Obsidian's styling. If you are using a custom theme, make sure you update the theme to the latest version. If you are still seeing visual anomalies, we recommend switching to the default theme for the time being.

Shiny new things

• The workspace now supports Tabs. To accommodate tabs, we've made a lot of tweaks to Obsidian behaviors.
• Way more than a fresh coat of paint, Obsidian has gone through an extensive redesign process to make the interface more robust, accessible, and easier to tinker with. Internally, we've been calling this new look "Dragonglass," and we'll be releasing a separate changelog to showcase all the changes that went into it.
• Notes now display the full note title inline with the note contents as an Inline Title. The view header is now disabled by default. You can add it back from Appearance → Show view header.
• By default, the UI is now in Frameless mode. The window title is hidden. In settings, you can choose between the new frameless mode, the custom window frame (old default), and using the native OS window frame.
• There's now an "accent color" color-picker in the Appearance settings to give your vault it's own unique style. Theme support may vary.

Improvements

• The Theme Gallery has gotten a major overhaul. Themes now support versioning just like plugins. Note: Themes that are not compatible with 0.16 have been marked as "legacy" and cannot be installed until they get updated.
• We have consolidated the hotkeys for opening new panes.
  • Ctrl/Cmd + Click on a link will open it in a new tab
  • Ctrl/Cmd + Alt + Click will open links in a new pane to the right.
  • Ctrl/Cmd + Alt + Shift + Click will open links in a new window.
• Auto-generated links to headings now keep more punctuation characters for better contexts.
• Added "Native menus" to show context menus natively for desktop only.
• Added "collapse all" button to file explorer and tag view.
• Added "Change theme" command for quickly switching between themes.
• Added "Find & Replace," Export PDF, Share, and text formatting items to macOS app menu.
• Added Shift + Up/Down hotkeys to expand search results while a search item is focused.
• Added "Title bar style" setting for switching between the custom app frame (default) and the OS-native app frame.
• Added "Fold more" and "Fold less" commands for folding lines under the cursor.
• Renamed "Split vertically" and "Split horizontally" to "Split right" and "Split down" to avoid ambiguity.
• Pressing Home will now move the cursor to the beginning of a list item.
• Obsidian Sync: The history view has a toggle to choose between seeing the version of a file at a point in time or seeing the diff.
• Added show-theme action to the Obsidian URI. It will open the given theme in the Community theme gallery. For example: obsidian://show-theme?name=Minimal

No longer broken

• Fixed bug with search results containing "path:" sometimes showing duplicate text.
• Fixed multi-line embedded queries not working.
• Fix memory leak with loading native system fonts.
• Fixed crash when file explorer is missing a sort order.
• Ctrl/Cmd+W can now close the vault switcher and help window.
• File explorer keyboard navigation properly ignores hidden files.
• Clicking to edit Live Preview widgets (e.g. tables or callouts) will now scroll the view to the beginning of the widget.
• Word count now works for any text file that can be opened, not just md files.
• macOS: "obsidian" will now be capitalized in the App menu.
• macOS: commands will no longer refer to Finder as "System Explorer."
• macOS: right-clicking on top of the cursor will no longer cause the word under the cursor to be selected.

Developers

• Workspace information is no longer saved to the .obsidian/workspace file. It is now saved to workspace.json.
• Added standard color picker component.
• Added has-active-menu class to file explorer item that received the right-click.
• Added list-bullet class to HTML markup for unordered list items.
• Theme developers: we have published a guide for helping get your theme ready for 0.16.

FAQ

Q. Why am I seeing the title of my note duplicated at the top of my note?

We now display the filename as an Inline Title to allow filenames to feel more attached to the note. If you already have the heading of your note matching the filename, you might notice some redundancy. You can disable this feature from Editor → Display → Show inline title.

Q. Where did the view header with my current view status go?

The view header is hidden by default. You can re-enable it in settings at Appearance → Advanced → Show tab title bar.

Q. Why does everything look so big/small?

The new update has made some changes to make Obsidian feel more native to your operating system. To adjust the overall scale of the UI, you can configure the UI Zoom level in Settings at Appearance → Advanced → Zoom level.

Q. How do I open notes side-by-side now?

The behavior of Cmd/Ctrl + Enter and Cmd/Ctrl + Click have changed to opening links in a new tab. To open links in a new pane to the right, you can use Cmd/Ctrl + Alt + Enter or Cmd/Ctrl + Alt + Click.

No longer broken

Fixed copying and pasting using the context menu.

Improvements

• Added support for .mov and .mkv files. Exact codec support may vary by platform.

No longer broken

• Fixed “Inter” not showing up in the font list. It will now appear at the top of the list for easy access.
• Graph view will now properly wait for fonts to load before rendering.
• Graph view groups can now be reordered by dragging and dropping again.
• Fixed Markdown embeds showing up with a large empty space in pop-out windows.
• Fixed editor search not showing up in pop-out windows.
• Pressing “Escape” will no longer unfocus a sidebar editor pane.
• The app will now fallback to a Github proxy when Github is inaccessible.
• Switching workspaces will now properly close all pop-out windows.
• Live Preview: Toggling checklist items in callout will no longer cause the callout to get collapsed.

No longer broken

• Fixed "Inter" not showing up in the font list. It will now appear at the top of the list for easy access.
• Graph view will now properly wait for fonts to load before rendering.
• Graph view groups can now be reordered by dragging and dropping again.
• Fixed Markdown embeds showing up with a large empty space in pop-out windows.
• Fixed editor search not showing up in pop-out windows.
• Escape no longer unfocuses a sidebar editor pane.
• The app will now fallback to a Github proxy when Github is inaccessible.
• Switching workspaces will now properly close all pop-out windows.

Core update

• Includes all new functionality and bug fixes up to Obsidian Desktop v0.15.6.
• Major update to the editor engine fixing several input related bugs.

iOS

• You can now choose user installed fonts.

No longer broken

• Fixed checkboxes not working in Live Preview.
• When the app loading fails, there is now an option to reload app in Restricted Mode (with plugins disabled).
• Fixed page preview not scrolling to specific location properly when hovering search results.
• Fixed linked panes keeps stealing focus when navigated.
• Fixed LaTeX math not rendering in pop-out windows.
• Fixed "Show File Explorer" and other similar commands not focusing on the pane when activated.

Improvements

• Renamed "Open current pane to new window" command to "Move current pane to new window."
• There is now a separate "Open current pane in new window" command for opening a pop-out window without closing the current view.

No longer broken

• Fixed reading mode in pop-out window not rendering when the main window is minimized.
• Fixed graph view in pop-out window not responding when main window is minimized.
• Fixed various suggestion items not rendering properly.
• x-callback-url now disallows file:/// protocols.
• Fixed hover preview not working in graph view.
• Fixed "focus on pane to left/right" commands not working within pop-out windows.
• Fixed "close all other panes" command not working within pop-out windows.
• macOS: Fixed App Menu items not working when pop-out window was focused not working within pop-out windows.
• Fixed styling issues within the Open Vault window.
• Fixed issue where pressing 'escape' in the graph view would cause the view to lose focus.

Developers

• If a plugin view crashes when getting created, the view will properly get cleaned up.
• leaf.view can now never be null.

Shiny new things

• Added "Toggle always on top" command to pin pop-out windows above all other windows on your desktop.

Improvements

• The native scrollbar styling for macOS is back. This can still be overridden by themes.
• Views dragged out into their own pop-out will now preserve their previous pane size.
• Automatically refocuses the view in pop-out windows when cycling between windows.

No longer broken

• Fixed "Open in new window" not giving the new pane focus.
• Copying to clipboard now works in pop-out windows.
• Fixed issue where the File Explorer didn't always respect the "default note location" setting.
• Backlinks in document will no longer disappear in pop-out windows.
• The toggle sidebar commands should now work again.
• Pop-out windows will now remember their position and size when restoring from maximize, minimize, or fullscreen.
• Fixed table wrapping issues in Live Preview.
• Fixed checkbox in callouts misaligned when using RTL.

Developers

• We've made several improvements to the workspace API to improve plugin compatibility with v0.15.X. If you've been experiencing compatibility issues with your plugin (views opening in the wrong leaf, files opening without focus), we recommend testing against this version to see if the issues have been resolved.
• For plugin and theme developers: we've made changes to the Suggest component's DOM structure. If your plugin is attaching itself to core Suggest components or mimicking the Suggest component structure, it will likely be impacted.
  • The new DOM structure is:

  - .suggestion-item
  	- .suggestion-content
  		- .suggestion-title
  		- .suggestion-note (optional)
  	- .suggestion-aux
  		- .suggestion-hotkey (optional)
  		- .suggestion-flair (optional)
  

• The behavior of workspace.getActiveFile has been updated to now return the file of the most recently active FileView. This change should improve compatibility for custom views now that sidebar views are focusable. If you were previously using workspace.getMostRecentlyActiveFile for v0.15.X compatibility, please switch back to getActiveFile.
• Note: Theme developers can avoid overriding the macOS native scrollbars by targeting body:not(.native-scrollbars) for any scrollbar styling.

Shiny new things

• You can now drag and drop panes across multiple windows.
• You can now drag a pane outside of the app to create a new window.
• You can now right click on a file or a link to open it in a new window.
• You can now rearrange the order of tabs in the sidebar.
• Pop-out windows will now save and restore their position across app restarts.
• You can now right click on the Obsidian Sync status indicator to bring up a menu of shortcuts for pause/unpause, change settings, view the sync log, or view recently deleted files.

Improvements

• Menu items are now grouped by function to make them easier to use.
• The "editor status" core plugin has been moved to an editor setting. It will also now show an icon instead of text.
• Pressing Escape when not focused on a pane now focuses the last active editable pane.
• The application menu on macOS now shows the assigned hotkey for each menu item.
• Added a pin icon to pinned sidebar views.
• "Focus on editor" command is now called "Focus on last note" and will restore focus to the most recently focused note.

No longer broken

• Fixed several vim hotkeys that were broken due to the CodeMirror 6.0 update.
• In vim mode, characters that are composed with AltGr now work correctly in normal and visual mode.
• Fixed mermaid not rendering in pop-out windows.
• Fixed embeds render with large empty space in pop-out windows.
• Fixed link with pane not working across pop-out windows.
• Fixed styling issues with translucency.
• Fixed Obsidian Publish upload dialog unable to "Use live version" in deleted/non-existent notes.
• Fixed font selector not showing all fonts.
• F1-F12 keys can now be bound to commands without a modifier.
• Fixed long filenames overlapping with buttons in the window titlebar.

Developers

• New enhancements for DOM elements and UI events: This applies to all derivatives of Node (like Element, HTMLElement, etc) and all derivatives of UIEvent (like MouseEvent, KeyboardEvent, etc)
  • You can now easily access the element or event's owner document (element.doc or event.doc) and window (element.win or event.win).
  • You can now use element.instanceOf(HTMLElement) or event.instanceOf(MouseEvent) to perform instanceof checks without having to worry about cross-window constructors.
  • HTMLElement now also has a onWindowMigrated hook that can be used to monitor when the element gets attached to different windows. This can be used to re-initialize views that depend on window globals.
• There are now workspace events for window-open and window-close.
• MenuItem now has a new method setSection(string). Items from the same section will be grouped together, in the order they were defined or first used. The default section (empty string) will contain all legacy/plugin/unspecified menu items and is usually put into a specific spot of the sort order (for example, before the danger items). Inspect the DOM to see existing sections' data-section.
• We've removed the ability to create MenuItem directly - please use Menu.addItem instead.
• On View, we've deprecated the onHeaderMenu and onMoreOptionsMenu in favor of a single onPaneMenu function with a source parameter. This new method will be used for both the header menu (right clicking on a tab header in the sidebar) and the more options menu (three dot menu).

Improvements

• Pressing Esc with a sidebar view focused will refocus your last note.
• Checkboxes within settings can now receive keyboard focus.
• Clicking on a view's options menu will now toggle it opened/closed.

No longer broken

• Left and right arrow keys now work within the search input again.
• Opening a view in its own window will now give the view focus.
• Inline images are now properly rendered inline with text.
• Fixed switching panes doesn't update the window title.
• Fixed issue with file explorer causing high CPU usage when your vault has many unfolded files showing.

Developers

• Added mod-active class to the tab headers when the view is active.
• Updated Mermaid to v9.1.2.

Shiny new things

• The Tag pane can now be navigated with the keyboard.

Improvements

• macOS-only: the title bar is now 2px taller.

No longer broken

• Plugin views will no longer get replaced when clicking on a link (such as Calendar).
• Fixed files not being opened inside the currently active split.
• Graph view interactions now works within a popout window.
• The tag pane will show nested tags again.
• Native scrollbars have been temporarily reverted on macOS due to the white background issue on dark theme.
• "About" window on macOS will now show the Obsidian version correctly.
• Ctrl/Cmd-clicking on the active file in the File Explorer will open it in a split instead of focusing the explorer.
• Popout windows are removed when switching workspaces.
• Vim mode: The ghost character (like #) that appears in an unfocused editor is now hidden.
• Navigating forward/backward in history will skip over some views such as File Explorer or backlinks.

Developer

• To account for sidebar views being able to receive focus, we have deprecated several Workspace functions whose behavior conflicted with user expectations.
• Added .is-focused class to the window body of the currently focused window.