Skip to content

Emerald v2.0.0

Choose a tag to compare

@github-actions github-actions released this 12 Aug 19:23
· 8 commits to main since this release

Emerald 2.0.0

Emerald 2.0 is the largest release so far, adding a complete reading workflow
and a fast visual way to explore a vault while preserving the app's small,
dependency-light C++/Qt foundation.

New

  • Added an in-pane Graph View with global and depth-1–3 local modes, folder
    and status filters, incoming/outgoing traversal, optional arrows, search,
    pan/zoom, draggable nodes, and background force-directed layout. Graph state
    participates in Back/Forward history alongside ordinary notes.
  • Added a per-vault Read Mode with a separate semantic document for tables,
    images, math, code blocks, rules, callouts, links, tasks, selection, and copy.
    Select text and press Ctrl+Shift+H to save or remove Markdown highlights
    without leaving Read Mode.
  • Added Obsidian-style callouts. A quote starting with [!type] becomes a
    continuous type-colored card with a unique emoji and optional custom title in
    both Edit and Read Mode.
  • Added collapsible nested list trees. Indented bullet, numbered, and task
    items belong to their nearest shallower parent and can be folded recursively
    in either mode.
  • Added Broken Links (Ctrl+Shift+B) and keyboard Quick Jump: hold Alt
    briefly, then type a visible link's hint to open it without the mouse.

Editor and navigation

  • Added pixel-smooth wheel scrolling while preserving native high-resolution
    trackpad input and smooth Read Mode keyboard scrolling.
  • Expanded table keyboard editing: Enter creates missing header structure,
    moves through body rows, and appends rows; Tab navigates and grows the grid.
    Formatting is skipped when a padded row would exceed the editor width, and
    tables remain plain Markdown in Edit Mode.
  • Improved list continuation, empty-item termination, mid-item splitting,
    wrapped-item alignment, task checkbox rendering, and ordinary newline input.
  • Added rich semantic Read Mode rendering for Markdown tables and inline
    formatting, local images, math, rules, fenced code, links, and task controls.
  • Vault defaults, including Home note, new-note folder, templates folder, and
    Read Mode, are now isolated per vault without adding metadata files.

Performance and fixes

  • Eliminated the severe slowdown caused by following wiki links in Read Mode.
  • Read/Edit switching now preserves a source-backed visual anchor, preventing
    wrapped lists from drifting up or down during repeated mode changes.
  • Fixed wrapped-link hit testing, stale autocomplete swallowing Enter, image
    preview regressions, clipped media, and numerous Markdown layout edge cases.
  • Improved heading hierarchy, blockquotes, lists, code blocks, tables, media,
    and selection behavior across the live editor and Read Mode.

Documentation

  • Expanded the in-app Emerald Manual to cover the complete 2.0 feature set,
    including Graph View, Read Mode, callouts, math, image attachments, mascots,
    responsive layout, external edits, settings, and every current shortcut.

Downloads

Platform File Notes
Linux (x86-64) Emerald-x86_64.AppImage chmod +x and run
Linux (ARM64) Emerald-aarch64.AppImage chmod +x and run
macOS (universal) Emerald-macOS.dmg drag to Applications; first launch right-click -> Open -> Open
Windows Emerald-win64.zip extract and run emerald.exe