Back to blog
releaseNovember 11, 202612 min read

v0.3.1 Release: Mermaid Wave 2, Multi-Window, Video Embeds & Searchable Settings

Ferrite v0.3.1 adds a rewritten git graph, a zoomable Mermaid viewer, YouTube embeds, real multi-window editing, search-first Settings, spellcheck, GitHub HTML, GFM table alignment, and CSV cell editing.

Ferrite v0.3.1: Mermaid Wave 2, Multi-Window, Video Embeds & Searchable Settings

Ferrite v0.3.1 is the follow-up to May's platform release. v0.3.0 rebuilt rendered editing, export, and the icon set. This one is about living in the editor: diagrams you can inspect, notes you can spread across windows, video in the preview, and a Settings tab you can actually search.

Summary: Mermaid wave 2 (git graph rewrite, zoom/pan viewer, fit-to-pane, sequenceDiagram autonumber, %% @pos layout hints). YouTube embeds with a thumbnail fallback. Multi-window editing with session restore. Search-first Settings. Optional spellcheck. GitHub-flavored HTML subset. GFM table alignment and CSV cell editing. Preview lock, Alt+Z word wrap, emoji and a separate rendered font. A long list of file-safety fixes, including CRLF preservation and exit dialogs that no longer resurrect discarded notes.

Language server support stays behind the lsp feature flag and moves to v0.3.2, along with SVG/PNG diagram export and drag-to-reposition.


Mermaid, second wave

The native diagram engine picks up the diagram types and interactions people were comparing against Mermaid Live.

Git graphs

gitGraph is rewritten against Mermaid's core grammar: tags, branch types, cherry-picks, and both left-to-right and top-to-bottom layouts. Commits sit on horizontal lanes instead of the earlier approximation.

A real diagram viewer

Click a rendered diagram, its popup button, or Ctrl+Click it. Ferrite opens a large native viewer with zoom, pan, and Select / Hand modes. It is dark-mode aware and does not take you out of the app. Thanks to @starSumi (PR #158).

Fit the pane

Wide diagrams shrink to the preview width instead of forcing a horizontal scroll through the whole document. Hover a diagram for a Fit / Native toggle (#165).

Other diagram work

  • sequenceDiagram autonumber — message arrows can be numbered, with a start and step, and autonumber off clears numbering from that point on.
  • %% @pos hints — %% @pos nodeId x y places a flowchart node after the automatic layout. Dragging nodes and writing positions back to the source is planned for v0.3.2.
  • Smoother edges — linkStyle with interpolate basis draws Catmull-Rom curves, including index lists such as linkStyle 0,1,2 interpolate basis.
  • Font Awesome prefixes — fa:fa-* labels no longer show the raw icon token in the node text.
  • Subgraph titles — multi-word and CJK titles stay intact, and the box width no longer wobbles when the title is the widest part (#159, #165).
  • Recoverable warnings — a bad %% @pos id, for example, still draws the diagram and shows the warning.

Very dense flowcharts (30+ edges) are more readable. Pixel-perfect parity with mermaid.js on those graphs is still v0.3.2 work.


YouTube embeds

A fenced-free embed syntax drops a video into the preview:

{{video https://www.youtube.com/watch?v=dQw4w9WgXcQ}}

On Windows, Ferrite plays the video in a child WebView. The player loads a local relay page that hosts a youtube-nocookie.com iframe, which is what YouTube accepts. Pointing the WebView straight at /embed/ produced Error 153; that path is fixed (#119).

If the WebView cannot be created, the embed is scrolled off-screen, or you are in a secondary window, Ferrite shows a thumbnail and a play overlay. Untrusted hosts never get a WebView.

Linux: inline playback still hits Error 153 on WebKitGTK (the relay page has no HTTP origin YouTube will accept). v0.3.1 shows the thumbnail and opens the video in your browser. Inline Linux playback is deferred to v0.3.2. Windows playback is unchanged.


Multi-window

File → New Window, or Ctrl+Shift+N (⌘⇧N on macOS), opens a second OS window with its own tab strip (#125).

  • Files you open go to the window that has focus, including single-instance handoff from Explorer or Finder.
  • Session restore remembers each window's geometry and tabs.
  • Settings → Files → Allow multiple Ferrite windows/instances (off by default) and ferrite --new-instance start a separate process when you want one.

Closing a window asks about modified untitled notes in that window, because those tabs disappear with it. On a full quit, Don't Save no longer writes the discarded buffer back into the next session. Save on exit saves every modified tab, not only the active one.


Tables, CSV, and GitHub HTML

Tables and spreadsheets

  • GFM column alignment — :---, :---:, and ---: render as left, center, and right. The toolbar cycles alignment and writes the delimiter back (#140).
  • Column guides in the raw editor — vertical guides line up pipes while you edit. They are display-only and turn off while word wrap is on.
  • CSV cell editing — double-click a cell in the rendered CSV view. Tab, Shift+Tab, and the arrow keys move inside the grid and stay there. Large lazy-loaded files still ask you to edit in Raw view. A same-length edit in the middle of the file is no longer wiped by the next cell commit (#196).

A GitHub HTML subset

Rendered and split view now understand a practical slice of the HTML GitHub allows:

  • <div align> (multi-line blocks)
  • <details> / <summary>
  • <kbd>, <sup>, <sub>
  • <img width height>
  • <br> and <kbd> inside headings

Named and numeric entities (&amp;, &rarr;, &#x2026;) render as characters instead of tofu (#173). Nested HTML and HTML tables are phase 3, scheduled for v0.3.2.


The Settings tab is no longer a long sidebar of sections.

  • A search field at the top filters every setting as you type, including keyboard shortcut names. "bold" finds the Bold binding. "zoom" finds font size.
  • Ctrl+F focuses search. Esc clears it, and Esc also closes Settings when nothing else has focus.
  • Chips (All / Appearance / Editor / Files / Keyboard / Terminal) show a live match count while you search.
  • With no query, you get up to eight recently changed settings, then the same Essentials the Welcome screen offers.
  • Version, update check, and project links live in an About popup next to Reset All.
  • Reset All asks first, and it keeps your recent files and saved session.
  • The language list shows all ten shipped locales: Czech, German, English, Spanish, Estonian, Japanese, Norwegian Bokmål, Portuguese, Russian, and Simplified Chinese.

A bad value in config.json resets that one setting instead of throwing the whole file away. A file that is not JSON is renamed to config.json.corrupt-… before defaults load, and saves are atomic. Changes hit disk within about half a second.


Editing

Day-to-day writing picked up a pile of small controls that used to require a settings dive or a workaround.

WhatHow
Word wrapAlt+Z (⌥Z on macOS). Command palette too.
Lock the previewInsert. The padlock blocks WYSIWYG, CSV, and tree edits. The raw pane stays editable.
Indent / outdentTab / Shift+Tab on a raw selection. The selection is not replaced.
Reload from diskCtrl+Shift+R. Dirty tabs ask first.
SpellcheckSettings → Editor. Off by default. English dictionary bundled. Squiggles, suggestions, add-to-dictionary.
Rendered fontSettings → Appearance. Same as editor keeps the old behavior.
New windowCtrl+Shift+N

Also in this release:

  • Arrow Up / Down moves between blocks in the rendered view. The status bar follows the caret instead of sitting on line 1.
  • Find scrolls the rendered and split preview to the current match.
  • Emoji in the document uses the OS emoji font instead of empty boxes. They are still monochrome; color emoji is a toolkit limitation.
  • Paste an image from the clipboard and Ferrite writes a PNG under ./assets/ and inserts the markdown. Untitled files open Save As first, so nothing lands in the process working directory.
  • Ctrl/Cmd+click or middle-click a link in the preview to open it without switching the block into source. A plain click still edits.
  • Typing undoes in runs. Characters typed on one line within about 700 ms are one Ctrl+Z step. A newline, paste, or caret jump starts a new step. The same rule applies in Raw, Rendered, and Split.
  • Rendered edits are in the document as you type. The unsaved dot appears on the first keystroke, and the raw pane in Split view follows within a frame.
  • A maximum line width centers the rendered column in normal mode, not only in Zen mode.
  • YAML frontmatter at the top of a file renders as a properties card. Edit it in the raw pane or the outline panel's FM tab.
  • The ribbon has a markdown cheat sheet and a back to previous tab button.
  • On Linux, selecting text publishes the primary selection, and middle-click pastes it. The toggle is in Settings → Editor.

The terminal can use its own font, and Powerline or Nerd Font glyphs fall back when you have one installed.


Files, windows, and platforms

  • macOS Finder Open With opens the file as a tab in Ferrite, on a cold launch and when the app is already running (#154).
  • Use system title bar (Settings → Appearance) is available on Linux and macOS. It needs a restart. Windows keeps the custom title bar.
  • Dragging a maximized custom title bar restores the window and then moves it. Double-click restore on Windows 11 no longer leaves the window unable to move or resize (#153).
  • CRLF files stay CRLF through rendered edits, formatting, TOC insert, and video-embed resize (#174).
  • Switching encoding on a dirty tab asks before it throws away unsaved edits (#197). Saving in a legacy encoding refuses characters that encoding cannot store, instead of writing &#NNNN; (#198).
  • Local file and folder links in the preview open in the OS file manager (PR #157).
  • Binary files open in the system default app instead of as garbage text (#142).
  • Opening a file from Explorer raises the existing Ferrite window more reliably (#147).

Fixes worth knowing about

Linux QA ran four full passes on Debian 13. The crashes and data-loss bugs from those runs are closed in this tag. The ones you would have hit:

  • Document Statistics crashed when a line started with §, ß, é, or CJK (#171).
  • Half-typed Mermaid (A}x{ --> B) aborted the app.
  • Editing inside a blockquote could drop the > or reset the heading level.
  • Click-to-edit landed the caret several characters off on lines with mixed bold, italic, code, and links.
  • Copying from a highlighted code block inserted spaces at token boundaries.
  • A video embed's resize handle snapped back when you released it.
  • Search in Files crashed or drifted on CJK queries (#178).
  • The first keystrokes in Settings search were dropped.
  • Alt+Z typed a "z" as well as toggling wrap.
  • Local images dropped into assets/ did not always appear in the preview (#164).
  • List items only rendered their first paragraph. Nested code, quotes, and tables now show, and Shift+Enter in a paragraph no longer deletes the blocks below it.

Default shortcuts that moved: Close Workspace is Shift+F12 (F12 stays Open Workspace). Numbered List is Ctrl+Shift+7, because Ctrl+Shift+N is New Window.


Thank you

@starSumi landed the diagram viewer, the markdown cheat sheet, the previous-tab button, the frontmatter card, outline polish, tab context menus, local-link opening, subgraph title width, Windows git-status fixes, and the Linux WebView CI dependencies. That is a large part of why this release feels finished.

Thanks also to everyone who filed the issues linked above, and to the translation work on Weblate that kept ten locales in the language list.


What's next: v0.3.2

v0.3.1 deliberately did not ship LSP. v0.3.2 is where that work, and the crate extractions, land:

  • Language server support on by default: diagnostics, hover, go to definition, autocomplete
  • FerriteEditor and the Mermaid renderer as standalone crates, including SVG and PNG export
  • Drag-to-reposition flowchart nodes, with %% @pos written back to the source
  • Inline YouTube playback on Linux
  • GitHub HTML phase 3 (nested HTML and HTML tables)

v0.4.0 remains the release for LaTeX math, right-to-left and bidirectional text, and read-only Office documents.


Upgrade

Windows

MSI or portable ZIP from the download page. The MSI is the signed install. An optional Inno Setup installer exists and is unsigned; prefer the MSI.

macOS

Apple Silicon or Intel .app from the download page. Gatekeeper can still warn on unsigned GitHub builds. Right-click → Open, or allow the app in System Settings. See macOS install notes.

Linux

# Debian/Ubuntu
sudo apt install ./ferrite-editor_amd64.deb

# Fedora/RHEL
sudo dnf install ./ferrite-editor.x86_64.rpm

# Tarball
tar -xzf ferrite-linux-x64.tar.gz
./ferrite

YouTube embeds on Linux show a thumbnail and open in the browser. Building from source now needs WebKitGTK 4.1 and libsoup 3 (libwebkit2gtk-4.1-dev and libsoup-3.0-dev on Debian/Ubuntu).

Rust

v0.3.1 still requires Rust 1.92 to build from source.

rustup toolchain install 1.92.0

Download v0.3.1 | View full changelog | Report issues

#release #mermaid #multi-window #video #settings #tables #spellcheck
Share this post:

Comments

Comments coming soon

Comments will be powered by GitHub Discussions. In the meantime, feel free to open an issue or start a discussion on GitHub!

Join the Discussion