Changelog

Shiny new things

• Canvas: Added "Groups" to canvas. Groups can be thought of as placemats for your cards. They always render below cards and dragging the group label will move all notes in the group at once. To create a group, select multiple cards then right-click and choose 'Create group.'

Improvements

• Canvas: Improved performance when interacting with large canvases.
• Canvas: On Windows and Linux, you now hold Ctrl to duplicate the selection instead of Alt. On macOS, this is still Option+Drag.
• Canvas: Added right-click and drag to pan around the viewport.
• Canvas: Added 'copy screenshot' menu item.
• Canvas: Added 'reset zoom' button.
• Canvas: Double-clicking the bottom of a card now auto expands it to the size of the contents.
• Canvas: The canvas will always zoom to fit on open.
• Canvas: PDFs and iframes that have been interacted with will stay loaded even when zoomed out.
• Canvas: text cards now have dynamic padding so they shouldn't appear with scrollbars on small sizes.
• Canvas: Web pages now have a label with the site title.
• Canvas: Right-clicking on web pages now gives the option to copy the URL or reload the page.

No longer broken

• Canvas: The connection menu will exclude embeds.
• Canvas: Fixed issue where deleted cards and connections would sometimes reappear and be un-selectable.
• Adding a hotkey to a default hotkey no longer results in the default hotkey being removed.

Developers

• Canvas files are now multi-line formatted when saved. This should make the diffs more human-readable when stored in version control.

Improvements

• Live Preview has been tweaked to avoid flashes of "unstyled" content while scrolling through larger documents.
• Canvas: We have updated how colors work inside of Canvas. The six colors in the color palette are now themeable. There is a new 7th slot with a color picker.
• Canvas: Added a new menu item to paste in a web URL. Right clicking on an existing web page in Canvas now shows an option to change the URL.
• Canvas: YouTube links will now automatically get inserted as Youtube's embed version.
• Canvas: There's a new 'help' button to view all the currently hotkeys available for Canvas.
• Canvas: Dragging a connection line from a file card now shows a menu with all outgoing links to quickly add them as connections.
• Canvas: Added a new 'Narrow...' menu option to file cards. This will narrow the card contents to only the selected heading.

No longer broken

• The frontmatter YAML will now always be hidden in reading mode. The "Show frontmatter" toggle now toggles the metadata section.
• macOS: Fixed bug in Canvas where cards would drag when ctrl-clicking.
• Fixed issue when using multiple cursors where an extra cursor would appear in the top right.
• .canvas files now show in the editor link suggest.
• Linux: middle-clicking on the canvas will no longer trigger 'paste.'

Developers

• Added a notice when opening a Canvas that fails to parse.

No longer broken

• Canvas: fixed bug where text nodes don't always save their content.

Improvements

• Canvas: 'delete' has been renamed to 'remove' to avoid confusion.
• Canvas: cards can now be dragged by the filename label.
• Canvas: Ctrl/Command-clicking on a filename label will open that file in a new tab.
• Other plugin views should now properly respond to selecting a card in the Canvas. This includes the Outline pane, the Backlinks pane, etc.
• Templates core plugin properly inserts into the canvas editor.
• The viewport will now pan while dragging nodes close to the edge of the screen.
• Pressing Shift-enter inside the file select modal in canvas will now create a file based on your current input (same as the quick switcher behavior).
• Improved appearance of file name modal when using "Convert to file..." Canvas action.
• Increased the max zoom distance in Canvas.

No longer broken

• Sync: canvas files will now sync between devices (oops!)
• Canvas: fixed bug causing editor to occasionally lose track of inserted text and cursor position when typing quickly.
• Canvas: connections cannot be drawn from a card back to itself.
• Canvas: fixed issue where shift-clicking on a card would cause the editor to appear in an unfocused card.
• Canvas: fixed text suggest menu not closing when clicking outside of a card.
• Canvas: Fixed dragging links from cards into their own cards.
• Canvas: Fixed dragging links from the embedded canvas editor.
• File explorer: added back missing 'Open in new window' command to the context menu.

Developers

See v1.1.1 in the Developer CHANGELOG.

Shiny new things

• Introducing the Canvas core plugin. You can now lay your notes out in an infinite, spatial canvas.

Improvements

• Ribbon items can now be rearranged (drag & drop) or hidden (right click on the ribbon for options). Configuration is also available in Settings (Appearance → Ribbon menu). Note: if you are using an existing plugin to manage the ribbon, this might interfere.
• Plugins can now be sorted by "Recently updated."
• Added theme version information to the debug modal.
• Added "Close window" command (Ctrl/Command + Shift + W).
• Pressing Shift + Enter in the editor Find Dialog will find the previous instance.

No longer broken

• Linux: fixed middle-click to paste.
• 'Split' commands will now focus the newly created tab group.
• Fixed issue where File explorer would not always select the right items when using shift-clicking.
• Popout windows will now open with the same zoom level as the main window
• Fixed Home behavior in task lists.
• Moving folders to the Obsidian trash (.trash) will no longer add a trailing .
• Fix ordered lists showing as bullets.
• Plugin gallery will no longer cache the results if there's no internet connection.
• macOS: fixed issue with spell check replacing the wrong word on the same line.
• Improved styling of text when the accent color is lighter than a certain threshold.
• Fixed "Fold more" and "Fold less" commands not working properly on list items.
• The File explorer will no longer capture arrow key events when modifier keys are used. This was breaking hotkeys such as Ctrl + Shift + →.
• Fixed issue with folds in Reading mode getting unfolded when creating a new tab.

Developers

• We have added a Developer CHANGELOG to our API repo. Moving forward, we will keep developer-facing changes cataloged here.
• Canvas uses a new JSON-based file format, see the spec.
• Added new metadata APIs.
• Added macOS calendar entitlements.
• Added support for fundingUrl in the plugin manifest. The donation URL will be shown in the plugin gallery entry.

Core update

• Includes all new functionality and bug fixes up to Obsidian Desktop v1.0.
• Ongoing UI overhaul with an emphasis on making the app more responsive and mobile-friendly.
• Phone-only: New bottom navigation bar includes forward/back arrows, tab menu, and quick access to your ribbon items.
• Phone-only: The left ribbon bar has been removed from the left sidebar. It is now accessible as a menu in the navigation bar. Tap to activate your most recent action. Tap and hold to see a list of all ribbon items.
• Tabs can now be used on both tablets and phones. On phones, tabs can be accessed with the button on the navigation bar.
• Phone-only: Added haptic feedback for the context menu and pull-down menu.
• Tablet-only: Some interface elements like menus and popups will now use the desktop version since there's sufficient space on tablets.
• Long-press links in Live Preview to show context menu.

No longer broken

• Fixed vim mode gj on the last line jumps up.
• Fixed numbered lists in unordered lists not rendering the number.
• Fixed long lines in sub-bullets adds jumping padding.
• Fixed some rendering issues with translucency.
• Fixed artifacts in tabs on Linux.
• Removed Github fallback CDN which is no longer in operation.

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.

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.

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.

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.