Emerald v2.1.0

Emerald 2.1.0

Emerald 2.1 adds private, Markdown-aware spell checking, a hold-to-view
keyboard reference, more faithful Read Mode rendering, and a consistent compact
interface across dialogs and menus.

New

• Added offline spell checking backed by Emerald's private, vendored
  Hunspell engine. US English is bundled with the app and needs no network
  connection.
• Added right-click spelling suggestions, Add to personal dictionary, and
  Ignore for this session. Code, math, links, URLs, HTML, and other
  non-prose Markdown ranges are skipped.
• Added optional, hash-verified Italian, German, French, and Spanish dictionary
  packs under Settings -> Spelling. Packs are published and updated
  separately from the application.
• Added a centered keyboard shortcut cheatsheet. Hold Alt+X to see the
  categorized reference and release either key to dismiss it without changing
  focus or triggering Quick Jump.

Rendering and interaction

• Fixed mixed inline styles in Read Mode, including highlights containing bold
  spans and strikethrough text containing wiki links.
• Made heading sections foldable in Read Mode.
• Reworked multi-line quote and callout painting to remove gaps, incorrect edit
  offsets, and stray corner pixels while keeping Read and Edit Mode aligned.
• Refreshed settings, spelling management, search, file pickers, update prompts,
  galleries, and other dialogs with one compact charcoal-and-emerald design.
• Improved dialog alignment and removed native dotted focus outlines while
  retaining clear solid keyboard-focus states.

Maintenance and documentation

• Self-hosted the pinned Hunspell source and dictionary snapshots with license,
  provenance, integrity, and review automation included in the repository.
• Added README screenshots for Read Mode and Graph View and expanded the manual
  and shortcut documentation for the new features.
• Extended UI, Markdown, spelling, performance, and security test coverage.

Downloads

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

Emerald spelling dictionaries 1.0.0

Versioned, hash-verified optional spelling dictionaries used by Emerald. Each NOTICE asset contains the corresponding upstream license and attribution.

Emerald v2.0.0

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

Emerald v1.6.1

Emerald 1.6.1

A security-hardening release with a small editor polish fix.

Security

• The built-in updater now accepts only trusted HTTPS release URLs for this
  repository and verifies every download against GitHub's SHA-256 digest and
  byte size before installing or opening it.
• External Markdown links are limited to http, https, and mailto, while
  local image previews are canonicalized and confined to the current vault,
  including across symbolic links.
• Creating notes from missing wiki links now rejects invalid, path-like, and
  reserved titles, and handles write conflicts without indexing or opening an
  invalid path.
• Legacy mascot migration is confined to the opened vault so it cannot import
  or remove metadata through paths outside that vault.
• Release Actions are pinned to immutable revisions, and downloaded Linux
  packaging tools are pinned by release and verified by SHA-256 before use.

Editor

• Wrapped continuation lines in bullet, numbered, and task lists now align with
  the item text. Nested list indentation is preserved without changing the
  underlying Markdown.

Development

• Added dedicated security regression tests, ASan/UBSan support, a parser fuzz
  harness, and scheduled security CI checks.

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

Emerald v1.6.0

Emerald 1.6.0

New

• Added a responsive mobile-width layout with dedicated Notes and Editor views.
• Added compact navigation for creating notes, searching, opening the menu, and
  moving between the note list and editor.
• Settings, folder, trash, and mascot dialogs now adapt to narrow windows.
• Desktop sidebar and editor sizing are preserved when switching between desktop
  and compact layouts.

Improvements

• Centered note titles and refined their spacing to make the title and body easier
  to distinguish without adding a divider line.

Fixes

• F2 now focuses the title when a vault opens without a current note by starting
  an unsaved Untitled draft. On compact layouts it also opens the Editor view.

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

Emerald v1.5.5

Emerald 1.5.5

Fixes

• Fixed title-field navigation on macOS so note history shortcuts work while
  editing the title, including unsaved draft notes.
• Fixed F2 rename focus for unsaved Untitled drafts.
• Pressing Enter on an empty Untitled draft title now moves into the note body
  without creating the note; entering a valid title still saves it normally.
• Command-click on macOS now follows wiki links from the active editing line.

Development

• Added richer synthetic vault profiles to the performance benchmark harness,
  including memory snapshots for startup, scan, search, editor, and mascot
  phases.

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

Emerald v1.5.4

Emerald 1.5.4

Navigation

• Unsaved New Note drafts no longer block note history navigation. Moving back
  or forward from a draft discards it and returns to saved notes only.

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

Emerald v1.5.3

Emerald 1.5.3

Interface

• New notes now open as untitled drafts with focus already in the title field;
  pressing Enter with a valid title creates the note and moves into the body.
• New Folder and Move to Trash dialogs now use compact Emerald-styled prompts.
• Long vault names in the sidebar now shrink with a dynamic ... while keeping
  the full vault path available in the tooltip.

Updates

• macOS updates now install in place from Check for Updates... and restart
  Emerald automatically after the new app bundle is copied.

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

Emerald v1.5.2

Emerald 1.5.2

Interface

• The left sidebar now shows the opened vault name instead of the generic
  "Notes" label.
• Mascot actions in the gear menu are grouped under a dedicated "Mascot"
  submenu.
• The settings dialog is larger, clearer, and better aligned.

Images

• Notes can now include Markdown images.
• Insert, paste, or drop images into a note to copy them into the vault's
  _attachments folder and insert a portable Markdown image link.
• Standalone image lines render as centered inline previews while keeping the
  underlying note plain Markdown.

Performance

• Reduced resident memory used by the search index, editor save tracking,
  mascot image caching, and updater downloads.
• Added current-RSS memory metrics to the development performance benchmark
  suite.

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

Emerald v1.5.1

Emerald 1.5.1

A performance-focused release for large vaults. This version keeps the app's
dependency footprint unchanged while making search, rendering, and startup work
scale better.

Performance

• Search ranking now uses indexed term frequencies, cutting repeated search
  latency sharply on large vaults.
• Startup search indexing runs off the UI thread, so opening a vault stays more
  responsive while the index is built.
• The note sidebar now uses a model-backed tree with direct path lookup instead
  of scanning every row when selecting the current note.
• Editor painting does less offscreen work, improving viewport render time.
• Math and mascot render caches avoid retaining one-off results, reducing wasted
  cache pressure while still accelerating repeated renders.
• External file edits now update the search index based on file metadata changes
  instead of only path/title changes.

Development

• Added development-only performance benchmarks for release-to-release tracking.
• Added performance budget checks and a CI workflow for the benchmark profile.
• Updated release workflow actions to the current major versions.

Downloads

Platform	File	Notes
Linux (x86-64)	Emerald-x86_64.AppImage	chmod +x and run
Linux (ARM64)	Emerald-aarch64.AppImage	chmod +x and run · glibc ≥ 2.39
macOS (universal)	Emerald-macOS.dmg	drag to Applications; first launch right-click → Open → Open. If still blocked: xattr -cr /Applications/emerald.app
Windows	Emerald-win64.zip	extract and run emerald.exe

Every download bundles its own Qt runtime. Built automatically by the Release
GitHub Actions workflow.