Changelog

Shiny new things

• Pasting HTML content will now be automatically converted to Markdown. Same for drag and drop. For example, links you drag from web pages will now generate [Display text](https://url) instead of previously just the URL.

Improvements

• Search and replace now has a new default hotkey on macOS Cmd+Option+F to avoid clashing with the native hotkey for hide window.
• Creating new notes from the file explorer or using the hotkey now always open in edit mode.
• When setting up sync on a vault that's older than the synced remote vault, the older files will be ignored and overwritten to avoid a mass rollback.
• Navigation history has been slightly tweaked to be more intuitive, and also remembers scroll sync properly.
• On macOS, closing the last vault and re-activating Obsidian will now re-open the last vault instead of opening the vault switcher.

No longer broken

• On macOS, quitting and restarting the app will properly restore the opened vaults.
• Translucency should now work again on app start on macOS.
• Drag and drop a file to open in a pane will now properly push the navigation history so going backwards feels more natural.
• Spellchecker will now split words that are adjacent to CJK characters.
• The "explain search term" button now works properly again.

Shiny new things

• You can now select multiple files in file explorer using Alt+Click, or multiple consecutive files using Shift+Click.
• You can now reorder starred items.
• You can now drag files from various of places:
  • Drag a file (or multiple files) from the file explorer, just like before.
  • Drag a file from a search result.
  • Drag a file from a backlink, or an unlinked reference.
  • Drag a file from the starred pane.
• You can now drop files to various places:
  • Drop a file (or multiple files) onto a folder to move it there. You can even do this with files you picked up from anywhere, like a search result. It doesn't have to be from the file explorer.
  • Drop a file to a pane's top header section to open the file in that pane.
  • Drop a file directly into the editor to insert it as a link. The generated link also follows your preferences, such as relative paths, or using Markdown links.
  • Drop a file in another application or in another Obsidian vault to generate an obsidian:// link the same way it's generated as "Copy obsidian url".
  • Drop a file to the starred pane to star it.
• You can now drag a supported file from your system explorer to a folder in Obsidian's file explorer to import a copy there.
• There is now a dialog with options for page size, landscape mode, and margin options for export to PDF.
• You can now choose the tab size in editor settings.

Improvements

• Quitting the app and restarting will now restore previously open vaults. This will also work on the "relaunch" button after an update has been downloaded.
• On macOS, Obsidian will no longer quit when all windows are closed.
• Pressing Tab will now insert spaces if Use tab to indent is turned off.
• Various visual improvements are added for dragging and dropping panes.
• The app window's title will now indicate the vault name.
• If you have too many ribbon icons, it can now be scrolled to access them all, instead of clipping out the last few icons.
• If the more options menu is too long, it can now be scrolled to access menu options that was previously off-screen.

No longer broken

• Sometimes after opening multiple popup windows, all hotkeys stop working. That shouldn't happen anymore.
• With an open note in Obsidian that's been edited outside or by a plugin, sometimes the last newline character disappears. That should no longer happen.
• Fixed some edge cases where custom CSS causes IME positions to overlap the current line.
• Vault switcher should now have more space for certain languages that take more space than others.
• File names with multiple non-breaking spaces will now link properly.
• The about setting tab no longer populates twice when you click on "Check for updates" twice.
• The community plugins page no longer populates twice when you click on a plugin name twice.
• Creating new files will no longer fail if there exists a file called "untitled.md" in lowercase.
• Global search's input box will now expand to take the full width.
• Sync will no longer allow restoring the current version.

Developers

• The workflow for augmenting CodeMirror has been improved:
  • Plugin.registerCodeMirror(callback) has been introduced to help plugins hook to CodeMirror instances that are already loaded, and also created in the future. This function is just a helper for Workspace.iterateCodeMirrors(callback) then Workspace.on('codemirror', callback)
  • Workspace.iterateCodeMirrors(callback) has been introduced to help plugins cleanup their CodeMirror events when the plugin unloads.
  • App.on('codemirror', callback) has been moved to Workspace.on('codemirror', callback). The old method will be deprecated and will now proxy to the new one. There is no more event system on App.

No longer broken

• Fixed preview "readable line width" option.
• Fixed preview pane could not fold lists and headings.
• Fixed YAML front matter not shown even when option is turned on.

Shiny new things

• Obsidian Sync is now available and can now be purchased. It features:
  • End-to-end encryption.
  • Selective sync.
  • Version history.
• You can now use the "Move file to another folder" command to move the current file without having to do a drag-n-drop in the file explorer.
• You can now Ctrl/Cmd hover in the file explorer to preview the contents of a file.

Improvements

• Graph view search filter now has a clear button.
• The file explorer will now automatically scroll when dragging files near the top or bottom edge.
• Tag suggestion will now match anywhere in the tag, instead of just from the beginning.
• You can now create internal links in Mermaid by specifying the class internal-link for the node. The app will use the contents of the node as the link. Example: class A internal-link;
• Quick switcher aliases now show the actual file path as well.

No longer broken

• Link auto-complete should no longer add an extra pair of ]] when another link exists on the same line.
• Mermaid text should now finally be properly scaled.
• The notice "Updated x links in y files" now properly shows number of files instead of always showing 1.
• Fixed some cases of blurry text caused by the lack of subpixel-antialiasing.
• Fixed [[ auto-conversion from chinese characters 【【.
• Typing should no longer lag when linked with another editor pane of the same file.

Developers

• Fuzzy search related functions prepareQuery, fuzzySearch, renderMatches, renderResults, sortSearchResults, are now available.

Shiny new things

• Quick switcher now auto-completes for aliases as well.

Improvements

• Creating a new file from "no file is open" page now respects the default location option.
• Invalid front matter now shows up as an error in the metadata section of preview mode.

No longer broken

• Deleting files and folders now properly remove them from the file explorer.
• Footnotes now work properly in exported PDF files.
• Fixed mermaid graphs don't scale properly when using a HiDPI/retina monitor, or when zooming the app.
• Link suggestion no longer suggests blocks for attachments like images or PDF files.
• Fixed pressing Enter to finish rename a file not working properly when using an IME.

Developers

• SuggestModal and FuzzySuggestModal are now available for use.

Improvements

• Exporting to PDF now respects the "show frontmatter" option.
• Themes/Snippets now excludes dotfiles generated by MacOS.
• Custom CSS is now applied as soon as the app loads.
• Tags in front matter are now split by space if there was any.

No longer broken

• Fixed search and replace in edit mode.
• Open themes/snippets folder now works properly.
• Search, backlinks and unlinked mentions should no longer glitch out when collapsing all results.

Shiny new things

• You can now download multiple themes and switch between them. They are now stored in the vault/.obsidian/themes folder. Be sure to disable the legacy option for obsidian.css when you do so!
• You can now add multiple CSS snippets, and choose to enable/disable them individually. They are stored in the vault/.obsidian/snippets folder.
• You can now check for third-party plugin updates and selectively update them.
• In preview mode, there is now a new section displaying the metadata of a file based on its YAML front matter.
• You can now give notes specific CSS classes using the front matter option cssclass. You can also specify multiple ones with the same syntax as tags and aliases, for example, cssclass: class1, class2. Combine this with custom CSS to selectively style notes.
• You can now sort tags in alphabetical order instead of by frequency.
• You can now collapse the front matter section in edit mode.

Improvements

• The custom CSS plugin has been merged into the app, under the "Appearance" setting tab.
• In preview mode, if the front matter fails to parse as YAML, an error message will be displayed in the code block if you had show front matter option enabled.
• Link suggestion will now suggest aliases of a file after you type |.
• Link suggestion no longer shows YAML front matter as a block to refer to.
• When renaming a file, Markdown links will now also change the display text if it matches the file name.
• File explorer has been improved to lag less on big vaults.
• Backlinks and unlinked mentions have been improved to lag less when there are many results.

No longer broken

• Highlights are now properly exported to PDF.
• After renaming a file, automatically updated Markdown links will now properly contain the .md extension.
• Choosing a spellcheck suggestion will no longer wipe adjacent characters.
• Creating or renaming a file now properly calculates backlinks to it.
• Embed images now shows up properly in block suggestions.

Developers

• moment.js has been replaced with moment-with-locales.js.
• CodeMirror has been updated to v5.58.3.
• A new event layout-change is has been added to Workspace.

Shiny new things

• Obsidian now has a native build for Apple M1 (Apple Silicon).
• There's now a build for 32bit Windows and arm64 Windows.
• There's also a build for Linux arm64.

Improvements

• Tags in front matter no longer requires the # character. You can now write tags: [tag1, tag2, tag3].

No longer broken

• Fixed unable to type in edit mode after inserting a template or opening command palette or quick switcher.
• Star/unstar file in more options menu has been added back.

Shiny new things

• You can now specify aliases in front matter. These will then show up in the [[ link suggestion, and auto-complete to [[Filename|alias]]. They will also be picked up in unlinked mentions. For example: aliases: [AI, Artificial Intelligence]. Add double quotes around your alias if it contains special characters.
• You can now specify tags in front matter. These will then show up in the tag pane, as well as in search queries using the tag: operator. For example: tags: ["#pkm", "#hype"].

Improvements

• Command palette and Quick switcher will now restore your cursor or selection when exiting.

No longer broken

• Graph filter tag operators no longer operate on links to non-existent files.
• The duplicate menu item "Copy obsidian url" has been removed from the more options menu.
• On Windows, you should now be able to drag the window from the top when it's maximized.

Developers

• frontmatter is now available in CachedMetadata.
• Some helper functions for front matter parsing are made available: parseFrontMatterEntry, parseFrontMatterStringArray, parseFrontMatterAliases and parseFrontMatterTags.
• The css class mod-root is now always added to the workspace center area.
• Deprecations: (the old name will remain in code for backward compatibility for a while)
  • Setting.addExtraSetting has been renamed to addExtraButton.
  • Workspace.getActiveLeafOfViewType has been renamed to getActiveViewOfType.

Improvements

• The updater has been improved to properly use system proxy settings when fetching downloads. (Requires installer update)

No longer broken

• Fix popups from IMEs for east Asian languages such as Chinese and Japanese not properly positioned for heading with larger font than body text.
• Fixed search not working for double-quote full word match that includes punctuation characters.

Improvements

• A mechanism has been added to deprecate specific versions of third-party plugins known to cause data loss. A notification will be shown to indicate that such a plugin has been disabled.

No longer broken

• Fixed right click menu in edit mode.
• Fixed negative path filters in graph search causes tags to be removed.
• Mermaid Gantt charts are now properly sized according to the view size.
• Search results can be scrolled again.

Shiny new things

• You can now right click on search results, backlinks and unlinked mentions to show a file menu for some shortcuts.

Improvements

• A new option has been added for changing the default mode (edit vs preview) when opening new notes.
• Graph filter query has been tweaked to prevent path: and file: filters from removing tags.
• Search queries with double quotes now properly performs full word search if your query starts or ends in a punctuation character.
• Allow mermaid internal links using the /Note internal link format.

No longer broken

• Clicking now properly hides context menus, which previously were sometimes left on the page if clicking on editable text.
• Fold all/unfold all now properly updates the fold indicator.
• Graph hover preview is now back.
• Ctrl-click on internal links should now work on MacOS.
• Popups from IMEs for east Asian languages such as Chinese and Japanese should no longer obscure the line you're typing on.
• Internal links now render properly in footnotes.

Shiny new things

• You can now right click internal links to see many file options, such as opening in new pane, revealing in file navigation, open with default app, etc.
• Global search will now show recent search queries when the search is empty.
• Global search now has an "x" to clear the search query.

Improvements

• Global search and backlinks pane now save your options for collapse results, show more context and sort order. Global search also saves match case and explain search term.
• Backlinks pane also saves the folding of the Linked mentions and Unlinked mentions sections.
• Several new API are now available for plugins to use.
• Plugin authors can now mark a required version of Obsidian for their releases. They can also provide a list of older versions of their plugin that's compatible to older versions of Obsidian.

No longer broken

• Fixed fold all previously did not work in preview mode.
• There was a race condition for saving large files on slower computers which could prevent saving the last few characters typed into the note. That should no longer happen.
• Checklist styles have been fixed, they should no longer have an awkward offset from the left side.
• Hover previews now properly renders embeds.
• Indenting from a numbered list to an unordered list no longer causes undefined to appear.
• Printing to PDF no longer generates clickable app://obsidian.md links for internal links.

Shiny new things

• You can now export notes to PDF.
• You can now fold headings in preview.
• Fold/Unfold all command/hotkey now works in preview as well.

Improvements

• Plugin API: Vault APIs now normalize all input paths.
• You can now see installed versions of third party plugins in the "Third party plugins" section directly.
• The "Use Markdown links" setting has been moved to "Files" tab and has been renamed to "Use Wikilinks" to avoid users unintentionally turning on Markdown mode.
• Search in preview now automatically selects the first result.
• <iframe> now has permission to show modal like alert().

No longer broken

• Word count now works for languages that previously didn't work, such as Hebrew and Georgian.

Shiny new things

• Community plugins page now has a download count, and is sorted using it.
• Clicking on the plugin information now goes to the community plugins page where more details can be found.

Improvements

• Third party plugins now store their plugin data in their respective folder.
• Third party plugins that fail to initialize will now show a notice about the failure.

No longer broken

• Lists in slides no longer show the collapse indicator.
• Tables in edit mode no longer shows a weird space in the middle.

Improvements

• API now exports View.
• Plugin onInit has been removed to avoid confusion.

No longer broken

• Third party plugins should no longer be disabled on reload.
• Clicking on a graph node should no longer cause an error in the developer console.

Shiny new things

• There is now a community plugins page to discover and install third party plugins.
  • Check out the updated sample plugin on how to structure your plugin and how to release.
  • See publishing instructions on how to add your plugin to the list.
• You can now uninstall third party plugins.
• More API has been made available.

Improvements

• Block and heading link suggestions are now sorted by best match.

No longer broken

• Spellchecker will no longer attempt to spellcheck < and > characters.
• Fixed updating the wrong part of the link in Markdown links when renaming files.
• Fixed text wrapping to next line, then jumping back to the same line when adding space character.
• Sized images will now stay at their specified size, even if the pane is smaller.
• Extra unnecessary scrollbar from heading/block embeds have been removed.

Shiny new things

• The Plugin API alpha is now available! Hype!
  • Keep in mind that the plugin API is in alpha status. Any part of the API could introduce breaking changes in a future release.
  • For plugin developers, see our sample plugin repo and the plugin api
  • To install a plugin, simply place the plugin files inside the folder MyVault/.obsidian/plugins/my-plugin/.
  • For users, currently there is no "app store" for distributing plugins yet. This will come in a future release.
• You can now search in preview.
• You can now fold lists in preview. However, the fold state is not saved yet.
• There is now a new command to copy the obsidian:// URI for a file.
• A new search action is now available for obsidian:// URIs. Here's an example: obsidian://search?vault=my%20vault&query=MOC

Improvements

• The app is now much quicker to launch for large vaults.
• Local graph now has a screenshot menu item too.
• Mermaid has been upgraded to v8.8.2.

No longer broken

• Switching from preview to edit now properly scrolls to the same place you were viewing.
• Fixed resizing panes sometimes glitches and causes other panes to become tiny.
• Fixed unable to change language when checking for updates.
• Fixed ogv video files not properly included.

Breaking changes

• Block references now require the ^ character to be part of the link, like so: [[Filename#^blockid]].
• Block auto-complete will generate this new format automatically.
• The old format from v0.9.5 [[Filename#blockid]] will stop working.
• A conversion tool is added for existing block references from v0.9.5. Use the Markdown format importer plugin's "Block ID upgrade". Remember to backup your notes since this operates on the whole vault.

Improvements

• Block auto-complete will also display and search the block ID if one is present.
• Block IDs can now contain the dash character -.
• Auto-complete trigger with the prefix #^ such as [[Filename#^ now behaves identically to [[Filename^.
• "Toggle checklist status" command/hotkey now adds the checkbox syntax - [ ] for any selected lines that does not already have a checkbox.

No longer broken

• Image size syntax now works for internal images using the Markdown standard link format.
• Link auto-complete no longer strip characters after a . in the filename when using Markdown links.

Shiny new things

• Block references and block embeds are now available.

  • Simply type ^ when linking to trigger the auto-complete: [[Filename^.
  • Use [[^^ to auto-complete blocks globally.
  • The generated link will look like this: [[Filename#blockid]].
  • Block IDs will be generated using the syntax ^blockid when using the auto-complete.
  • Alternatively, you can manually create the block ID using any alpha-numeric character.
  • The block ID must be located at the end of the paragraph or list item, and must include a space character before the ^.
  • To identify more complex blocks, like tables, you can add the ^blockid as its own after the block you're referring to. There must be an empty line before and after ^blockid for this to take effect.
  • Quick reminder that this syntax for block reference isn't portable Markdown (no other tools support it yet), so please use some discretion when considering working with other tools!

• You can now auto-complete headings and blocks globally.

  • Be aware that this may be slow if your vault is large.
  • Auto-complete blocks globally by typing [[^^.
  • Auto-complete headings globally by typing [[##.

• There is now a new command for toggling the checkbox state between [ ] and [x]. Ctrl/Cmd+Enter is the default hotkey.

Changes

• The community theme page has been re-styled to be easier to use.
• HTML <iframe> now has a sandbox attribute added for extra security.

No longer broken

• Fixed removing links to an opened file causes the backlink pane to sometimes keep showing the removed link.
• Fixed inability to see the last few characters when editing table that's longer than screen width.
• Malformed Markdown URLs no longer cause parsing failures.
• Linking an unlinked mention now shows up in linked mention right away.