Changelog

Improvements

• Switching between files will now keep the undo/redo history for the last 20 files, unless the file was changed externally. Not available for the legacy editor.

No longer broken

• Fixed readable line length not properly applied when line wrapping is turned on.
• Search will now properly unfold folded areas when highlighting the match.
• Fixed wikilinks at the beginning of the line causes it to inherit styles from the previous line.
• Fixed a rare case of data loss due to race condition caused by clicking on a link and triggering the loading of the additional syntax highlighting library.
• Fixed gutter alignment for empty lines above headings.
• Fixed mermaid diagrams overflowing.

Improvements

• Edit mode now supports headings in lists.
• Embedded content generated by plugin custom handlers (like image in Admonitions and Dataview) are now rendered in both Live Preview and Reading view. This will be a temporary addition until we can come up with a proper Markdown rendering API that handles nestable rendering contexts better.

No longer broken

• Ctrl/Cmd+C now copies the whole line again if there is no selection.
• Fixed several parsing issues with formatting symbols in wikilinks.
• Fixed an issue where the Tab Size setting could change how indented lists are interpreted in edit view. This will now always recognize a tab character as 4 spaces, as required by Markdown's specifications.
• Fixed a crash when pressing up (or using k in vim mode) on a --- separator that's out of screen.
• Fixed a crash that happens sometimes when pressing page up or page down (or the equivalent commands in vim mode).
• Fixed some plugins could cause line wrapping to fail and grow the width of the editor.
• Code blocks will now line wrap in reading view, to stay consistent with editing view.
• Fixed code block's language flair stopped showing up when indented in Live Preview.
• Fixed math blocks inside blockquotes and lists are rendered outside.
• Improved parsing of footnote references and definitions.

Developers

• getSectionInfo() is now implemented for custom code blocks in Live Preview.

Improvements

• When changing default edit mode between Live Preview and Source mode, the new setting will now be automatically applied to all panes.
• Fixed default edit mode, which will now use Live Preview when not using Legacy editor.

No longer broken

• Fixed Live Preview sometimes unable to drop at the end of the document.
• Fixed reading view clips out the first line of the document when in document search is active.
• Drag and drop external files from the file system now preserves file extension in the display text if creating an external link.
• Fixed some plugins CSS causes Live Preview's selections to break.
• Fixed when using in document search or clicking on a global search result, the search highlight is sometimes hidden due to Live Preview.
• Fixed using in document search and replace does not highlight the next match when replacing.
• Fixed sometimes selecting multi-line text results in a weirdly rendered selection box.

No longer broken

• Fixed line wrapping not working with panes smaller than 700px.
• Fixed unresolved links in Live Preview not taking into account link aliases.

Shiny new things

• There is now a new Core plugin called "Editor status" which adds a status bar item showing you the current editor mode. You can also use it to toggle the editor mode.

Live preview improvements

• Internal links to non-existent files will now look dimmer than regular links.
• Fixed drop cursor is invisible in dark mode, also fixed drop cursor doesn't position correctly when document is scrolled.
• Fixed IME on MacOS sometimes causes duplicate characters to be entered.
• Fixed vim mode g related keys causes vim mode to crash until app is restarted.
• Middle click now opens internal links in new panes.
• Removed very faint background colors on external links.
• Fixed pressing Enter on an indented line does not keep the indent properly.
• Fixed long tables broken again due to an engine upgrade.
• Fixed tables has a weird extra spacing after the last | character.

Improvements

• Word count will now no longer re-calculate on every change, but instead re-compute at most twice every second, to spare some CPU time.

Developers

• The changed event on MetadataCache now contains the file contents as well as the parsed metadata object.
• There is now two helper functions for HTMLElement: isShown() which tells you whether this element is shown, and onNodeInserted which can add a callback for when the element is shown. These statuses depend on the element to be attached to the DOM and require not having any parent or ancestor with the css display: none.

Shiny new things

• Added basic RTL (right-to-left) text support. The option can be found in Settings > Editor.

Live preview improvements

• Fixed pasting from websites causes duplicate text to be inserted.
• Fixed sometimes the list bullet, or the checkbox shows up duplicated when selecting text.
• Improved the onboarding modal for selecting whether to use legacy editor or live preview.
• Relaunching after changing the legacy editor option now properly saves the option value, without having to wait for one second.
• When switching out of legacy editor, all edit panes will automatically use the default edit mode, rather than always staying in source mode.
• Fixed some actions like indenting and unindenting sometimes moves the cursor to unintended spots.
• Fixed an issue where selections look really bad if the first line of the document has a list.
• Internal links that start with # for heading sections will now hide the # when not selected to avoid confusion with tags.
• Fixed vim mode scrolling commands like zz, zt and zb.
• Fixed blocks like embeds and custom code blocks aren't properly included in the fold if they're at the end of the fold section.
• Fixed re-focusing on the editor sometimes causes the selection to jump to the beginning of the file.
• Improved inline footnotes parsing.

No longer broken

• Fixed tooltips wrap text in awkward spots.
• Fixed outgoing links unlinked mentions cuts off items that has a dot in the file name.
• Fixed changing image alt text does not update in reading view.

Live preview improvements

• Restored legacy editor to be default for now.
• Fixed gutter elements (line numbers and fold indicators) misalignment.
• Fixed Live Preview sometimes run into situations where it stops being parsed and highlighted halfway down the document.
• Fixed drag and drop text duplicates instead of moves selected text.
• Fixed several operations such as pasting, undo/redo, drag and drop, etc, causes duplicate characters or phrases to linger in the document.
• Fixed Ctrl/Cmd+Shift+Z stopped working for undo.
• Fixed full line embeds has an extra line after it.
• Improved external images rendering when on its own line.
• Empty headings will now keep the # characters in view to help see that it's an empty heading.
• Inline LaTeX will no longer be accidentally recognized when the ending sign is followed by a digit like $10.
• Fixed several commands that sometimes mis-position the selection after the command executes.
• Spellchecking is now properly applied to wiki links.
• Fixed some themes and plugins accidentally introduces margins, causing editor selections to misbehave.
• Fixed vim mode jumps by two lines sometimes.

Improvements

• Reverted editing/reading icon state. We will try to improve this in a future version.
• Improved Markdown formatting commands like bold and italics detection when selecting the outside layer.
• Markdown formatting commands now ignores whitespace characters at the beginning or ending of the selection when being applied.
• Backlink in document can now be turned on by default in the settings page of the core plugin "Backlinks".

Shiny new things

• Obsidian Sync now has a bulk restore functionality for deleted files.
• "Preview mode" has been renamed to "Reading view" to avoid confusion.

Live preview improvements

• Live Preview is now enabled by default. To switch to the old CodeMirror 5 based editor, toggle the "Legacy Editor" option.
• You can now set the default editing mode to Live Preview or Source Mode.
• Vim mode is now available for both Live Preview and Source mode.
• Completed task lists are now crossed out and greyed out to match reading view.
• Improved handling of up/down arrow keys interacting with blocks like embeds and code blocks.
• Improved selection when clicking on previewed blocks.
• Improved selection when selecting across hidden Markdown formatting syntax.
• Fixed drag and drop does not show caret where the drop will occur, and also sometimes inserts garbage content when dragging within the editor.
• Improved detection of inline HTML blocks.
• Improved blockquote handling.
• Fixed deleting auto-matched brackets like [ with backspace not deleting the closing counterpart ].
• Fixed HTML comments could cause a crash in the editor parser.
• Fixed clicking or selecting the end of the file selects to the beginning when there is a block at the end.

No longer broken

• Fixed code block has an extra indent on the first line in reading view.
• Quick Switcher will now create new files relative to the file of the current active pane when new file option is set to be relative to current file.

Developers

• Breaking change: the data-task css class has been moved to the line element, rather than being on each piece of <span>.
• The API for CodeMirror 6 has now been opened up. To deeply integrate with CodeMirror 6, you will be required to write an Extension to augment the editor. More details and tutorials will be available later.

Live preview improvements

• Spell checker languages can now be changed on Windows and Linux. On MacOS, the system native spell checker is used, which automatically detects the language.
• Spell checker will now skip over things that shouldn't be spell checked, such as code blocks, links, and math blocks.
• Improved code block syntax highlighting colors.
• Fixed fold all command not folding inner folds.
• Fixed heading folds does not load sometimes, causing the fold state to be lost.
• Fixed frontmatter not foldable.
• Fixed image links with titles. Fixed links surrounded by <> not linking properly.
• Improved bottom padding handling when backlink in document is enabled.
• Fixed editor suggestions continue to show up after switching documents.
• Fixed indent soft-wrapping mis-calculating tab sizes.
• Fixed bare links with <> disappears.
• Fixed rendered code blocks could overflow the editor.
• Fixed characters past the line wrapping threshold not selectable using the mouse, happens with long tables, or with line wrapping disabled.
• Internal links rendered by plugins are now handled within rendered code blocks.
• Improved handling of list bullet when the cursor is at the beginning of the line.

Improvements

• Global search panes will no longer continuously run in the background when the pane is not in view.
• Fixed overflowing tooltips.
• Fixed drag and drop internal links on Windows looks weird.

Live preview improvements

• Inline LaTeX is now supported and rendered.
• HTML blocks, including iframes are now rendered.
• Added data-task for all tokens on a list item with checkbox to facilitate css styling.
• Improved gutter alignment for fold icon and line numbers.
• Added code syntax highlighting for source mode and live preview (including legacy editor).
• Improved code block styling when cursor isn't active.
• Implemented Ctrl/Cmd+Click on Markdown links.
• Fixed Markdown links with "title" not working correctly.
• Removed hard-coded Ctrl/Cmd+G search hotkey.

Improvements

• Fixed legacy editor not properly scrolled to the top when switching document.
• Improved handling of custom panes when plugins are no longer installed.
• There is now a "Copy share link" in the community plugin's information page.
• Leftover panes from disabled plugins will no longer be automatically closed. They will now show up as an un-recognized pane, and if the plugin is re-enabled, they will work again.

Shiny new things

• You can now use drag and drop to re-arrange heading sections from the Outline pane.
• You can also drop an outline item into the editor to generate a heading link.

Live preview improvements

• Folding state is now properly saved.
• Fixed embed, image, or code blocks related page reflows making selection and interactions stop working.
• Fixed sometimes the page becomes plaintext with no highlights halfway.
• Fixed switching document does not scroll back to the top.
• Fixed document keeps scrolling up when selecting the last few lines.
• Fixed clicking on search results from global search, backlinks and outline pane not properly highlighting the matching location.
• Removed hardcoded editor folding hotkeys.
• Fixed unable to extract heading on macOS due to context menu also selecting word.

No longer broken

• Fixed clicking on an external link freezes the app for engine versions using Electron 12.

Live preview improvements

• Fixed mouse drag selection jumpiness.
• Improved IME handling.
• Fixed link aliases broken.
• Fixed rendered images still showing link.
• Fixed dynamically resized blocks such as query causes selection to stop working after they resize.
• Fixed indentation width not updating when swapping CSS themes.
• Fixed block quotes always have background and border in source mode.
• Fixed external file:/// images not working.

Improvements

• Plugin and theme download counts now have thousands separators.

Live preview improvements

• Backlink in document is now available for Live preview, which can be toggled in the pane menu.
• Mermaid and query blocks are now rendered.
• Some custom code blocks from plugins are now rendered.
• Implemented auto-pairing of brackets for Markdown formatting symbols such as $, =, ~ and %.
• Improved handling of block quotes.
• Improved image size handling.
• Improved Markdown link styling.
• Fixed image alt text not live updated.
• Fixed empty lines in code blocks.
• Fixed Option+ArrowUp/Down keys on MacOS not performing native cursor functions.

Improvements

• Added show-plugin Obsidian URI action. Example: obsidian://show-plugin?id=admonition
• Added notice for indexing large files taking too long to help debug indexing stuck issues.
• Obsidian now live-reloads the app and appearance options when the configuration files are changed on disk, to avoid issues with sync solutions overwriting each other with older versions.

No longer broken

• Fixed some syntax not highlighting for code blocks in preview mode while in dark mode.
• Preview should now render reference style Markdown links and images correctly.
• Obsidian Sync should no longer sync dot files and dot folders within plugin folders when community plugin sync is turned on.
• Fixed legacy editor's replace all function.
• Fixed adapter rename fail to work for dot files.
• Fixed copy from preview mode sometimes doesn't copy all the text.
• Fixed toggle strikethrough always adds more ~~ instead of removing.
• Pressing Enter when in an empty nested block quote will now only exit one level of block quote.

Live preview improvements

• Added list-bullet css class for theme styling.
• Fixed multiple cursors were added with Ctrl/Cmd+Click rather than Alt+Click.
• Fixed mermaid not rendering properly in preview.
• Improved block LaTeX rendering, fixed consecutive blocks not rendering.
• Fixed last line of document can't be selected when LaTeX blocks are in the document.
• External link icon should no longer be shown for embedded images.
• Fixed having a URL in image alt text breaks parsing.
• Fixed barelinks in footnotes disappears.

Live preview improvements

• Separators (---) are now implemented.
• Headings will now always show the # characters when the cursor is on that line.
• Fixed wikilink embeds not working with aliases or sizes using the | character.
• Fixed embedded documents not live updated.
• Implemented embeds using Markdown embed syntax.
• Improved visuals of list items by replacing list bullet character with a dot.
• Checklists now have their list bullet hidden.
• Fixed two wikilinks with alias on the same line causes the first one to disappear.
• Fixed empty wikilinks disappears.
• Added external link icon.
• Checkbox now has a data-task attribute added.

No longer broken

• The insider build toggle in Settings > About is now back.

Shiny new things

• Live Preview (also known as "WYSIWYG" mode) is now available for insider testing.
  • To enable it, go to Settings > Editor > Experimental Live Preview. Changing this option requires a restart to take effect.
  • The live preview mode is highly experimental and many bugs are expected. Please report bugs in the Discord server under the insider-desktop channel.
  • Once you turn on this option, there is a command to toggle source mode as well as a pane menu option.
  • Current features
    • Hide Markdown formatting syntax.
    • Embedded notes, images, audio, video, PDFs and notes using the wikilink syntax will show a preview in the editor.
    • Embedded images using the Markdown syntax from external sources will show previewed.
    • Block ($$) LaTeX will show a preview. Inline LaTeX will be implemented in a future release.
    • Checklists will be replaced with a checkbox. Clicking on it will toggle the check status.
  • Not implemented yet and coming soon
    • Embeds using Markdown link syntax.
    • Inline LaTeX.
    • HTML blocks.
    • Custom code blocks (including plugin rendered blocks like Admonition and Dataview).
    • Improved list bullets (and hide bullet with checklists).
    • Tables.

Improvements

• Added webp image support.
• Obsidian Sync
  • The remote vault selection dialog has been reworked to prevent accidentally connecting to a different remote vault, causing unintentional vault merges.
  • A warning has also been added to confirm the merging of local and remote vaults when the local vault already contains files.

No longer broken

• Copy code block button now also shows up on code blocks without a language.
• Fixed tabs becoming spaces within code blocks in preview mode.
• Fixed tab size not respected in preview mode.
• Fixed right clicking on search result matches not working.
• Fixed backlink in preview mode not updated when switching to an empty note.
• Fixed embeds in exported PDF documents not showing page title.
• Fixed code blocks in exported PDF documents sometimes contain duplicate characters when copied to clipboard when using Obsidian's dark mode.
• Fixed code blocks in exported PDF not wrapping.
• Fixed app zoom hotkeys stops working after opening a PDF document.
• Changing font size will no longer cause the cursor in the editor to behave erratically.
• Fixed navigating to headings, block IDs, and search results sometimes not scrolling down properly.
• Fixed navigating in local graph sometimes causes the navigation history to skip over a file.

Developers

• There is now an append function for both the Vault and the Adapter APIs.
• There is now a function to sanitize HTML called sanitizeHTMLToDom which returns a DocumentFragment of the sanitized HTML content.
• You can now setInstructions for an EditorSuggest.
• There is now a wordAt function on the Editor interface.

Core update

Includes all new functionality and bug fixes up to Obsidian Desktop v0.12.19

• Improved graph view animations.
• Heading rename.
• New theme store.
• Slash commands.
• New plugin APIs now available for the latest plugins to use.
• Tons of bug fixes.

Editor

• There are now new commands for copying, pasting, and opening the context menu, which can be assigned to the toolbar or the pull down menu for convenience.
• Upgraded CodeMirror 6 which should come with many bug fixes and performance improvements.
• Copy and paste is now handled just like the desktop app.

Obsidian Sync

• Fixed version history page not showing size and device info.
• Restoring files using version history will no longer error out with "This version is already the latest version".

Android

• If you're using Android 11+, you will be prompted for the new file access permission. This is unfortunately required by the latest Play Store policy.
• Android vaults should no longer show duplicates if you've selected a vault in Documents/Obsidian.
• Renaming a vault on Android should no longer cause it to disappear from the list.

iOS

• The iOS app will now wait for iCloud to sync back configuration files before opening the vault to prevent load failures. This fixes the "plugin failed to load" popups that happens sometimes.

Improvements

• Rename heading now has a command in addition to the previous context menu action.
• Improved theme statistic handling.

No longer broken

• Fixed editor suggestions for links and tags sometimes not working due to a race condition.
• Fixed current theme delete button sometimes shows in the next line.

No longer broken

• Fixed link suggestions sometimes disappears with large vault.
• Fixed heading rename doesn't work if there was no link to the heading.
• Fixed empty sidebar does not save collapsed state properly.
• Fixed theme manager sometimes showing no theme installed.