Changelog

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.

Shiny new things

• In preview mode, internal links to notes that don't exist yet are now given the CSS class is-unresolved, and now shows up in a different color than links to existing notes.
• You can now downsize images using the new syntax:
  • For Markdown images, use ![AltText|100x100](https://url/to/image.png)
  • For embeds, use ![[image.png|100x100]]
  • To have the image scale according to its aspect ratio, omit the height ![[image.png|100]]
• Obsidian Publish:
  • Backlinks! Turn it on to add the new backlink section at the end of each page.
  • Your site can now be styled with custom CSS! Just upload either obsidian.css or publish.css. You can also upload both so you can use your existing obsidian.css and add some extra tweaks for publish in publish.css.
  • There's a new mode you can turn on called "sliding windows". This overhauls your site's navigation to open links beside the current page. Inspired by Andy Matuschak's website
  • Page URLs now encodes space characters as + instead of %20 for a cleaner look.

Changes

• Obsidian now recognizes .bmp, .svg, and .tiff images.
• Hover preview now pops up where your cursor is, rather than at the position of the link.
• Improved performance when computing backlinks for large vaults.
• Improved performance when auto-completing links for large vaults.
• Embeds got their styling tweaked to be less prominent and less distracting.

No longer broken

• Deleting folders on Linux should no longer give an error message.
• Hover preview now fixed for graph view. It stays up nicely and disappears only when the cursor is off the hover and the graph node.
• Fixed a possibility that the hover preview gets stuck when clicking on the link.
• Fixed some characters not decoded properly when using obsidian:// URLs, such as the comma %2C.
• Removed duplicate backlinks for links within footnote definitions.

Shiny new things

• Clicking on checkbox within an embed block or a hover preview now updates the underlying file.
• Embedded notes now update when the underlying file is changed.
• New "Workspaces" plugin allows saving the entire workspace, including panes with their open files as well as all sidebar configuration. Especially useful if you use a vault for multiple purposes to jump between different pane configurations quickly.
• When using global search, you can now copy the search results file list. This can be optionally formatted as wikilinks and/or as lists.
• Hover preview can now be scrolled.
• Hover preview can now stack, meaning you can hover links inside a hover preview and pop out another preview for that link.

Changes

• Publish plugin now has an "unchanged" section which can be used to un-publish files.

No longer broken

• Local graph search filter no longer filters out the current file, which causes everything else to disappear.
• Resetting graph to default now properly resets forces as well.
• Changing search queries now saves to workspace properly.

Shiny new things

• There is now a publish plugin that works with Obsidian Publish. For more information, check out the Obsidian Publish Service
• Graph now has an option to tweak when the text fades out.
• You can now mouse hover in graph view with Ctrl/Cmd to bring up the hover preview if the page preview plugin is enabled.
• If your vault is large, there is now a loading progress bar when starting the app, instead of freezing and not functioning until the app properly loads.

Changes

• Clicking on search results and backlinks now scrolls to the Markdown section containing the first result in preview mode.
• Clicking on search tab now focuses on the search textbox so it can be typed in right away.
• The graph simulation engine has been rewritten to bring even more performance and save battery. Note that the graph simulation engine is responsible for computing where each node moves.
• The graph rendering engine has been tweaked to initialize a bit faster.
• Graph filters have been re-categorized to differentiate between display options and forces. Changing display options now no longer re-activates graph simulation.
• When opening global search with selected text, the query is now properly double-quoted if the query contains space characters.

No longer broken

• Fixed styling of backlink/unlinked mentions broken by the previous release.
• Navigating backward/forward should no longer cause the pane type to change from edit/preview to graph, backlinks or outline.
• Slides can now be styled via custom CSS without having to use more specific rules.
• obsidian:// URIs now fixed for Linux.
• Fixed more instances where preview scroll was reset when scrolling with large images.

Changes

• Search queries on graph now applies to all nodes, including tags and links to files that haven't been created yet.
• When hovering graph nodes, the node name now shifts down to avoid being covered by the mouse cursor.

No longer broken

• The account page now works again. This did break before and we've taken more steps this time to make sure it won't happen again.
• The vault chooser's "Create vault" functionality has been restored.
• Obsidian URI's shortcut mode obsidian://vault/vaultname now properly recognize URI encoded characters such as Chinese characters.
• Previewing documents with large images that are longer than your your screen no longer causes jumping or flickering when scrolling.
• Hovering graph nodes will now stop hovering when the node moves away from the cursor.
• In some rare situations, the app would freeze when loading, where nothing can be clicked and the app is completely unresponsive. This shouldn't happen anymore.

Shiny new things

• Graph view has been completely revamped.
  • New options for filtering are now available. You can now:
    • Filter files using same syntax as search. This can be especially useful to exclude certain folders like daily notes with path:-"Daily notes".
    • Choose to show #tags.
    • Choose to show attachments such as images, audios, and PDFs.
    • Choose to hide links to non-existent notes (only show existing files).
    • Choose to hide orphan notes (files that do not have links, and is not linked to).
  • New layout options are available to customize the graph to your vault. You can now:
    • Choose to show arrows for links.
    • Change the size of nodes and the thickness of links.
    • Change the centering force, the repelling force, the link force, and the link distance.
  • Local graph also has a few new option available. You can now:
    • Choose to hide incoming or outgoing links.
    • Choose to showing neighbor links. Disabling this option hides links between neighbor notes.
  • You can now navigate the graph using the keyboard. Arrow keys to pan, + and - to zoom, Shift to speed up movement.
  • All graph options, including local graph depth and zoom level, are now persisted through restarts.
  • Dragging to pan now has inertia. Zooming has been reworked to be much smoother.
  • Graph colors now support custom CSS color: rgba() values as well as opacity: 0.5.
  • New graph CSS classes are .color-fill-tag, .color-fill-attachment, .color-fill-unresolved, and .color-arrow.
  • Graph simulation is now done in a worker thread. This should make large graphs much more manageable.
  • Several optimizations have been implemented to make the graph blazingly fast on vaults of all sizes. Many tricks are commonly used in modern day video games!
• Obsidian now supports obsidian:// URIs. For the user manual, check out the help doc Advanced use > Using obsidian URI.
  • Remember to use %20 to encode the space character, and %2F to encode the forward slash /.
  • obsidian://open?vault=myvault will open the vault "myvault".
  • obsidian://open?vault=myvault&file=mynote will open the file "mynote" inside the vault "myvault"/
  • obsidian://open?path=%2Fabsolute%2Fpath%2Fto%2Fmynote will open the file at the absolute path "/absolute/path/to/mynote" assuming a vault exists for the one of the parent folders.
• The two shorthand from v0.8.15 are still available:
  • The vault format: obsidian://vault/myvault.
  • The vault + file format: obsidian://vault/myvault/mynote.
  • The triple slash format for absolute paths: obsidian:///absolute/path/to/mynote or on Windows obsidian:///C:\path\to\mynote (forward slash also works).
• New CSS classes are added for #tags in the editor for those interested in styling different tags in different colors. For a hypothetical tag #mytag, the class will be .cm-tag-mytag. Unfortunately, this only supports English letters, -, and _, since those are the limitations of CSS class names.
• New CSS classes are now added to <body> to indicate the operating system. They are .mod-macos, .mod-windows, and .mod-linux.
• Markdown importer can now convert Bear style highlight ::highlight::.

Changes

• Global search and edit mode find functionality now copies selected text into the search bar when triggered.
• The vault switcher window now has a language switcher.
• Search should now be much faster if only using file: or path: operators, because the file content does not need to be loaded.

No longer broken

• On Windows, the vault switcher should now show vault name instead of the full path, which took a lot of unnecessary space.
• Splitting a new pane sometimes caused the new pane to be very thin. That should now be fixed.
• Clicking on file:/// links should now work properly on Linux. This was broken on a previous release.
• On MacOS, sometimes when double clicking the app titlebar to zoom, the window disappears and can't be made to reappear even if restarting the app. This will no longer happen.

Shiny new things

• The app now registers the URL scheme "obsidian://". This will attempt to open a file in any previously opened vaults.
  • On MacOS, this requires installer version 0.8.12+ to work.
  • To open a vault that you have previously opened, use the format obsidian://vault/vaultname, where vaultname is the name of the folder of the vault.
  • To open a file inside a vault, use the format: obsidian://vault/vaultname/path/to/file.
  • To open a file with an absolute path, use the triple slash format: obsidian:///absolute/path/to/file or on Windows obsidian:///C:\path\to\file (forward slash also works). This will open the file in the most nested vault that's capable of opening this file.
  • If the URL does not do anything, then it means the file does not belong to any vault you have previously opened.
  • If the vault opens, but does not navigate to the specified note, then it means the file of that path was not found.
  • On Linux, you will have to setup an obsidian.desktop file with Exec=obsidian %u. Details see here.
• Alphabetical sorting has been improved.
  • Sort is now case insensitive.
  • Sort correctly understand accent characters such as "é" to be the same as "e".
  • Numbers are now naturally sorted, so "1", "2", and "10" will now sort in the expected order.
• Outline items are now collapsible.

Changes

• Embed can now be rendered up to 5 layers deep.
• Pasting images now use a 14 digit timestamp format "Pasted image 20200914050118.png" instead of a regular number "Pasted image 15.png".
• Graph view will now prioritize rendering frames instead of performing physics simulation, which previously caused multi-second lags on large graphs.

No longer broken

• Fixed Frameless titlebar text is not properly center aligned.
• Linking an unlinked mention now properly removes the entry from the unlinked mention section.
• Removed hidden titlebar when fullscreen which caused the top section of the app to not accept clicks.
• Drag and drop panes no longer cause the moved pane to lose CSS styles and pane headers.
• MacOS can now double click the frameless window header to zoom or un-zoom.
• Numbered lists with checkboxes now renders correctly.

Changes

• Auto-complete Markdown links now generates the note's name in the display text instead of the full path.
• Checkboxes are now re-colored to match our theme if your installer version is 0.8.12+.
• We have restored link auto-completion for hitting the # key, because otherwise it wouldn't be possible to auto-complete headings when using Markdown links.
• Latex $ symbol will auto-pair when selecting text and hitting the $ key.
• Fullscreen will now hide the titlebar.

No longer broken

• Open in default app now works once again.
• Command palette can now show more than 5 results.
• The vault switcher window style has been fixed.
• Titlebar text is now properly centered.
• Folder and file suggestion popovers now show in the correct position when the page has scrollbars.
• When linking unlinked mentions, the linked entry should now disappear from unlinked mentions list.

Shiny new things

• The entire app is now frameless. This also means you can use custom CSS to change the color/appearance of the top bar.
• We've added buttons for navigating backward/forward on the top left of the app.
• There is now a new plugin called "Translucency", which will make the app translucent. Linux is unsupported for now. Windows users must also re-install the app using the v0.8.12+ installer to be able to use this.
• Strikethrough ~ and highlight = will now auto-pair when selecting text and hitting the respective keys.
• There are now new commands for "Edit file title" and for "Copy file path".
• A new option is available to disable line-wrapping in edit mode.

Changes

• Link suggestion no longer triggers auto-complete when pressing # or | because it's not always intended. Instead, hit Tab first to auto-complete, then type the character normally.
• Selecting text in preview mode now prevents it from being optimized, where previously the selection would disappear when scrolled out-of-view.
• You can now middle-click on graph nodes to open the note in a new pane.

No longer broken

• On Linux, using the mouse backward/forward navigation buttons no longer fires twice.
• Sometimes in edit mode, the collapse/expand triangle overlaps the text. That's now fixed.
• Navigating back to a file that was already deleted shouldn't cause an error anymore.
• Checkboxes with a numbered list now appear on one line instead of wrapping to the next.
• Numbered lists with checkboxes now shows the number instead of hiding it.
• Fixed search operator tag miss every other result within the same file.
• Fixed a rare occurence of scroll lost when typing in a scroll-synced edit/preview configuration.
• Fixed heading not highlighted in preview mode when using the outline plugin if heading is on the last line of the note.

Shiny new things

• Update Electron to v10.1.1.

Changes

• Checkbox now uses a more modern style thanks to the new Electron update.

No longer broken

• Line wrapping used to cause a weird space to appear on the second line when the previous line ends with any kind of formatted text. This is fixed by the new Electron.

No longer broken

• Removed extra space at the bottom of the app.
• Account tab should now load properly.
• Embeds should now appear in backlink pane again.
• Backlink pane no longer show a scrollbar when it shouldn't.
• Backlink pane now updates properly when files are changed outside.
• Graph view no longer crashes when loading initially, or when files are changed outside.
• Fixed unlinked mentions links the wrong item.
• Fixed switching from editor to preview doesn't scroll on large documents.
• Fixed scroll-sync lag with edit mode open.
• Fixed scroll-sync not scrolling to the top on the other pane.
• LaTeX inline blocks $$ no longer has the space & digit requirements like $.
• WIP translucency plugin disabled, will be re-enabled next release.
• Updated translations.

No longer broken

• Linking to headings using [[filename#]] should now properly show suggestions when # is typed, instead of requiring an additional character to be typed first.
• In some rare cases, vaults with many files would freeze when loading up. This should be fixed now.

Shiny new things

• Search & backlinks now has an option to sort results, similar to file explorer.
• File sort order now includes sorting by creation time.
• Local graph nodes are now in decremental size from closest to farthest.
• A new search operator tag:#mytag is now available, which will only match tags that are parsed exactly as tags (for example, #mytag inside a code block will be properly ignored).
• A new hotkey has been added to create note in new pane.
• The Zettelkasten prefixer plugin can now set Zettel ID format, similar to daily notes.
• Daily note/Zettelkasten prefixer: Template file now accepts {{date:format}} and {{time:format}} just like the template plugin.
• Frontmatter in preview now has a CSS class to facilitate styling.

Changes

• Graph view has been greatly optimized. File changes only trigger incremental change detection to re-compute graph instead of a full scan.
• Search and backlinks now refreshes when files in the vault are changed. This update is also done incrementally to minimize performance impact.
• Backlinks pane has now been optimized when switching files or editing note, it will no longer cause lag to the editing experience.
• Opening help vault now wipes the folder first, which prevents older version of the help docs sticking around when they have been renamed.

No longer broken

• Fixed Cmd/Ctrl-click links and tags in edit mode sometimes requires a 2nd click.
• Consecutive tables now include proper spacing between them instead of being stuck together.
• In the file explorer, you can now click on file names while renaming them without exiting rename mode.
• Fixed footnotes with embedded documents not linking to the right footnote reference when clicked.

Changes

• Hovering the unlink pane button now highlights the pane itself as well.

No longer broken

• Clicking on a checkbox should check the correct box instead of the one 3 lines down, oops.
• Clicking an outline pane link would sometimes not work depending on pane configuration. That's fixed now.

Changes

• The cache file that was previously in vault/.obsidian/cache is now moved to the "APPDATA" folder under APPDATA\Obsidian\ObsidianCache\VAULT-ID.json. This should resolve issues with sync applications that caused conflicts with this file. See Electron documentation for the precise location of APPDATA on your platform.
• Removed non-functional work-in-progress publish plugin that was accidentally added in v0.8.6.
• Removed console.log of the i18n dictionary that was also accidentally added in v0.8.6.