Learn more

Changelog

Follow Obsidian updates and improvements.

Improvements

  • New icon for the Properties view.

No longer broken

  • Properties: Fixed autocomplete attempting to insert []() style Markdown links if "Use Wikilinks" is disabled in settings.
  • Properties: The "All Properties" view will treat properties as case-insensitive. For example, instances of "TAGS" and "tags" will be shown as the same property.
  • Properties: Fixed frontmatter inside Canvas text cards generating console errors.
  • Properties: Creating a link to a nonexistent note will no longer insert an extra set of "]]" brackets.
  • Properties: Fixed copy/pasting text within properties not working.
  • Properties: Fixed "Edit file property" command not showing in the command palette.
  • Properties: The "Remove" menu item in the context menu of "All Properties" has been renamed to "Unassign type" to avoid confusion.

Shiny new things

Introducing Properties. A simple and durable way to add tags, aliases, dates, and other metadata to your notes. Your properties can even include links to other notes.

property-editor

Usage

  • New visual editor for properties in Live Preview and Reading mode.
  • Property types:
    • Text — supports internal links
    • List — supports internal links
    • Number
    • Checkbox
    • Date
    • Time
  • New commands for interacting with properties:
    • Add file property (Ctrl/Command + ;)
    • Clear properties
    • Edit property
    • Show all properties
    • Show file properties
  • All properties sidebar pane shows a list of all the properties across your vault, and number of uses for each.
  • File properties sidebar pane shows the properties for the active file.
  • Cut/copy/paste properties.

Portability

Properties are saved directly to your note as frontmatter, a special section at the beginning of your file, encoded in YAML. This makes your note metadata readable in any plain text app, and compatible with many tools that support YAML frontmatter.

Improvements

  • Tag autocomplete now uses a fuzzy search algorithm.
  • PDF: Added “Copy as quote” and “Copy annotation” context menu options.
  • PDF: Added a button to copy annotations from the annotation popup.
  • PDF: Added “Copy link to page” to PDF thumbnail context menu.
  • Mermaid as been upgraded to v10.

No longer broken

  • Fixed: PDF Viewer single page view resets to first page.
  • Fixed: PDF viewer search settings unclickable when toggling sidebar.
  • Fixed bug where closing an pop-out window with an active modal would keep the modal active.
  • macOS: In frameless window mode, the top-right buttons no longer shift when creating/closing tab groups.
  • File Recovery modal will now show a loading state when loading large vaults.
  • Workspace: fix "follow link under cursor" commands in Canvas.
  • Canvas: nudging selection should not cause stacked tabs to scroll.
  • Outline: Fixed outline not rendering if the view was opened via the "Show outline" command.
  • The "New tab" view will now show the current hotkeys.
  • Fixed sometimes arrows and markers disappear from mermaid diagrams. (Credits to @Bunker-D)

Developers

  • Vault: createFolder now return a TFolder.
  • Metadata: FrontMatterCache no longer inherits from CacheItem.
  • Theming: new CSS variables have been added for Properties that start with --metadata.

About Properties

Internal Links

Internal links can be added to frontmatter using the following syntax:

---
link: "[[Link]]"
linklist:
  - "[[Link]]"
  - "[[Link2]]"
---

tag/alias/cssclass vs tags/aliases/cssclasses

As of 1.4.0, we're deprecating the "tag", "alias", and "cssClass" frontmatter keys. The new property editor will automatically migrate to tags, aliases, and cssclasses and the values will automatically be converted to lists.

The old keys will still be identified correctly in the app, but the property editor will always prefer tags and aliases.

Improvements

  • When using stacked tabs the close button is always displayed on the spine

No longer broken

  • Social cards and meta descriptions are now automatically stripped of Markdown formatting syntax

No longer broken

  • Removed command that wasn't ready for release just yet.
  • Fixed styling issue where extra space was being added between lists and sublists.

New shiny things

  • New Appearance setting to apply a custom app icon. Supports .ico and .png files.
  • Added support for deep linking in PDFs. Links can be created by right clicking on a PDF's table of contents, an annotation, or any selected text.
  • New "Adapt to theme" menu option for PDFs. Enabling this will override the PDF appearance so its rendered to match the styling of the current theme

Improvements

  • Tab close button is now hidden for inactive tabs and will only appear on hover. This creates more space for file names inside the tab.
  • Improved how headings are displayed. Headings in Live Preview and Reading mode should now more closely match in appearance. Note this requires installer version 1.1.9 or above.

No longer broken

  • Spellcheck setting is now stored app-wide properly, instead of having some vaults overriding others.
  • Live Preview: Markdown tables are now allowed to start immediately after headings without a blank line.
  • Fixed bug where embedded PDFs and markdown files sometimes lose their scroll position.
  • Fixed issue where the initial switch from edit mode to reading mode causes the scroll position to be lost.
  • Fixed issue where reading mode scrolls unexpectedly when opening new tabs.
  • Canvas: Allow opening external links in webviews.
  • Mermaid: Fixed some color issues.

Developers

New CSS variables:

  • --p-spacing defines the spacing between paragraphs (defaults to 1rem).
  • --heading-spacing defines the spacing above a heading when it follows a paragraph (defaults to 2.5x paragraph spacing).

Shiny new things

Improvements

  • Pressing Shift Enter while the [[ link suggest is showing will now skip the autocomplete and accept the current input as the full link.

No longer broken

  • Pressing esc while renaming a file will now properly cancel the rename instead of accepting the change.
  • Fixed PDFs not loading in pop-out windows when the main window is minimized.
  • Fixed issue where the [[ link suggest would not always work if ]] was not found on the current line.

Improvements

  • Reverted behavior change for links in pinned tabs. Clicking them will now open the link in another visible tab that is not pinned.
  • Reverted behavior for "Open to the right" as well as the Ctrl/Cmd + Alt + Click modifier. A new tab group will now always be created for the new tab.
  • When deleting a file, if the open tab containing that file has navigation history, the tab will no longer be closed. Instead it will show the most recent file from the history.

No longer broken

  • Prevent math from inserting links that execute JavaScript when clicked on.
  • Prevent plugins from breaking the PDF viewer.
  • Fixed lag issues from warnings generated by plugins misusing renderMarkdown.
  • Includes all new functionality and bug fixes up to Obsidian Desktop v1.3.3. This includes the new PDF viewer.
  • Live Preview: Reduce flickering and flashing when selecting text.
  • Adding text to an existing file via Share menu will always append text to the end of the file.
  • iOS: Fixed Canvas unable to drop images dragged from other apps.
  • iPad: Fixed issue where cursor and scroll position are messed up after dismissing the keyboard via the virtual keyboard's "close keyboard button."
  • iPad: Fixed switching apps causes Obsidian to lose text focus.

No longer broken

  • Fixed "split right" command not always creating a new tab group.
  • Bookmarks: Fixed bookmark group rename not working.
  • PDF: Fixed PDF reload when other files are changed.
  • Fixed clicking in documents with embeds, images, or raw HTML sometimes causes scroll jump.

Shiny new things

  • YouTube and Twitter links can now be embedded within your notes using the Markdown image embed syntax (i.e. ![](https://www.youtube.com/...)).
  • Clicking on external links inside <iframe> now properly open them in the default browser.

Improvements

  • Improved Live Preview rendering performance when moving the cursor.
  • Quick switcher: Bookmarks no longer rank higher in the search results.
  • PDF tabs will now automatically reload the PDF file when it is modified outside of Obsidian.
  • New hotkeys for interacting with the File explorer:
    • F2 to start renaming the focused file.
    • Space to open the focused file.
    • macOS: Enter to start renaming the focused file (to follow the OS convention).
    • macOS: Cmd + ArrowDown to open the focused file.
  • Live Preview: Markdown tables now require a blank line before them in order to render. This makes the behavior consistent with reading mode and offers better interoperability with other Markdown apps.

No longer broken

  • Linux: fixed issues with middle-click triggering paste when it shouldn't.
  • Renaming a file in the tab title bar now finishes the rename when using the Enter and Tab key.
  • Long tables that exceed the view width will now show a scrollbar.
  • Fixed missing first column when pasting a Markdown table.
  • File Explorer: fixed "Reveal file in navigation" not always scrolling the file into view.
  • Fixed Alt + Click in file explorer not setting the focused file properly.
  • Fixed alignment of icons inside tree components.
  • Search: Clicking filenames in the search results will now respect the "Always focus new tabs" preference.
  • Frontmatter will now still be recognized if there are spaces after the ending ---.
  • Fixed file saving interrupted when closing or quitting. Now Obsidian will properly wait for the file to be saved before closing.

Improvements

  • We've redesigned all the tree components (e.g. File Explorer, Outline view) to make the visual hierarchy more clear. This will likely impact any custom themes that you're using.
  • PDF: Improved text selection.
  • PDF: Added menu for embedded PDFs.
  • New behavior for "Open to the right" as well as the Ctrl/Cmd + Alt + Click modifier. Instead of always creating a new tab group, if there is a tab group to the right of the current tab, it will open the link in that tab group.
  • Outline: The outline view now supports keyboard navigation and preserves folded headings.
  • Obsidian Sync: Improved how Sync handles changing the casing for folder names (e.g. "some folder" → "Some Folder").

No longer broken

  • Collapsing items in the file explorer will now look visually better (previously the fold indicator of child elements would also appear to collapse as well).
  • Bookmarks: Fixed bookmark group not being populated in the Edit Bookmark modal.
  • Bookmarks: Hover preview no longer immediately hides after opening.
  • Bookmarks: Opening a bookmark with "Always focus new tabs" disabled will now still focus the newly created bookmark.
  • Spellcheck is now enabled when renaming files from the file explorer or from the tab title bar.
  • Backlinks: Fixed mod-clicking on backlinks not respecting the "Always focus new tabs" preference.

Developers

  • App will no longer show errors when plugins don't provide a "Component," to renderMarkdown, they will now just show a warning.

Shiny new things

  • All new PDF viewer.
pdf-viewer

Improvements

  • Clicking on links in a pinned tab will now open a new tab instead of reusing a random existing tab.
  • Bookmarks: Added new "Bookmark this block" menu item when right-clicking on a block ID.
  • Bookmarks: Bookmark view will now show an error state if the bookmarks.json file is malformed or corrupted.
  • Spellcheck is now enabled by default in new vaults.
  • Inline titles now have spellcheck enabled.
  • When Auto convert HTML is enabled, HTML tables will now be converted to markdown tables on paste.

No longer broken

  • Fixed slower performance of live preview when using popout windows on a secondary monitor.
  • Fixed opening files from File Explorer not giving focus to the new tab if "Always focus new tab" is turned off.
  • Fixed issue with multiple cursors having the incorrect selection color.

Developers

  • Updated PIXI.js to v7.2.4.
  • Updated Turndown to 7.1.2.
  • Updated Mathjax to v3.2.2.

Breaking changes

  • Removed support for app://local URLs. These were reported as a potential vulnerability when using iframes.

No longer broken

  • macOS: Text in the "Look up" menu item will now be trimmed to 40 characters.
  • Bookmarks: New unnamed groups will now be called "Untitled group" instead of "Untitled folder"
  • Bookmarks: Bookmark context menu items will now also refer to "Bookmark groups" instead of "folders" to avoid confusion.
  • Bookmarks: Bookmark group must always have a title.

Developers

  • Fixed issue with navigator.clipboard API not working in popout windows.
  • If you were relying on app://local for functionality within your plugin, you should use vault.getResourcePath(file: TFile) and vault.adapter.getResourcePath(vaultPath: string) as a replacement. These also works on mobile.
  • Includes all new functionality and bug fixes up to Obsidian Desktop v1.2.6.
  • Added Bookmarks core plugin and removed Starred core plugin.
  • Android: Fixed bug where Bluetooth keyboard could cause the app to restart.
  • Android: Fixed bug preventing files from being dragged in the file explorer due to the context menu appearing.

In this update, we revisited some of our older core plugins and provided more than just a fresh coat of paint. Most notably, the Starred plugin is going away in favor of its successor: Bookmarks.

Bookmarks

The Starred core plugin is going away. Introducing: Bookmarks.

Bookmark just about anything in Obsidian: files, folders, graphs, searches, headings, blocks. Organize your bookmarks in the much more robust Bookmark view. Reorder bookmarks with drag-and-drop. Create Bookmark Groups to organize your bookmarks into collapsible sections.

Search UI improvements

new-search-ui

We've reorganized the Search UI to make things more intuitive and make room for more options. Like being able to bookmark search queries right from here:

bookmark-search-ui

Hotkey settings improvements

New filtering options

hotkey-filtering-options

Search by hotkey

search-by-hotkey-ui

Misc. improvements

  • Added Editor setting to open new tabs in the background.
  • Suggest modals now support "page down" and "page up" as well as "home" and "end" keys for faster keyboard navigation.
  • Links with folder paths will now automatically insert an alias to the base filename (e.g. [[folder/file]] will expand to [[folder/file|file]])
  • Added "Close tab group" command as well as option to close a tab group from the tab group dropdown menu.

Bug fixes

  • Canvas: Fixed query blocks not rendering in text cards.
  • Export to PDF will now always export in "light mode."
  • Fixed slider tooltip overlapping with cursor.
  • macOS: Fixed Export to PDF rendering the wrong font.
  • Fixed folding arrows being misaligned on list items.
  • macOS: double-clicking the sidebar close buttons in the window frame will no longer trigger the window getting fullscreened.
  • Fixed "Fold more" command not folding the current line if the cursor is on top of a heading.

Improvements

  • Added new command "Create new note in current tab."

No longer broken

  • Bookmarks: Better handling of bookmarks when syncing across devices. Should fix issues reported of bookmarks disappearing when using Obsidian Sync.
  • Canvas: Fixed two-finger pinching when default wheel behavior is set to "zoom."
  • The "rename" modal will no longer report the rename as successful if the rename failed.

Important: Now that Bookmarks are available on mobile, the starred core plugin has officially been removed.

Improvements

  • The ribbon context menu will now show the ribbon icons next to each menu item to make it easier to identify which ribbon items are enabled/disabled.

No longer broken

  • Bookmarks: Fixed bookmarks view not saving what bookmark groups are collapsed.
  • Bookmarks: Fixed the positioning of the bookmark view's "no bookmarks" message.
  • macOS: "Look up" context menu item will now show a max of 40 characters.
  • Android: Fixed bug where file explorer could not drag files due to the context menu appearing.
  • Canvas: Fixed bug where pressing "edit" didn't always zoom in far enough to edit the file.
  • Fixed bug where sometimes it was impossible to drag files into a similarly named folder.

Improvements

  • Added sitemap.xml

No longer broken

  • Fixed issue with home pages sometimes returning a 404 error