From 092e0483cd64ce33d97ab28133a3ae63435bddf8 Mon Sep 17 00:00:00 2001 From: Paris Theofanidis Date: Sat, 16 May 2026 20:25:42 +0300 Subject: [PATCH 1/3] docs(site): add feature cards for edit mode, images, links, window state, external editor MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Catches the index page up with capabilities shipped in 1.3.3 and 1.4.0 that weren't reflected in the features grid: - Inline Edit Mode (1.4.0 — WYSIWYG over earlier Notion-style mode) - Inline Images (1.3.3 — local and HTTPS via om-asset: protocol) - Smart Links (1.3.3 — hover preview, open in browser, right-click menu) - Window State (1.3.3 — size/position/fullscreen restored across sessions) - External Editor (earlier — one-click "open in IDE" from toolbar) Co-Authored-By: Claude Opus 4.7 (1M context) --- site/index.html | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/site/index.html b/site/index.html index eeb4b32..2b780bd 100644 --- a/site/index.html +++ b/site/index.html @@ -84,6 +84,26 @@

Pinch to Zoom

Drag & Drop

Drop any Markdown file onto the app window or Dock icon to open it immediately.

+
+

Inline Edit Mode

+

Press Cmd+E to edit directly in the rendered document. Notion-style block menu, formatting shortcuts (Cmd+B, Cmd+I, Cmd+E, Cmd+K), and a raw-markdown escape hatch when you need it.

+
+
+

Inline Images

+

Images load directly in the document — both local paths (relative or absolute) and HTTPS URLs. PNG, JPEG, GIF, SVG, WebP, AVIF, ICO, and BMP supported.

+
+
+

Smart Links

+

Hover any link to preview its target in the status bar. Click to open in your default browser. Right-click for a menu to copy or open the URL.

+
+
+

Window State

+

The app reopens exactly where you left it — window size, position, and fullscreen state are restored across sessions.

+
+
+

External Editor

+

One click sends the current file to your favourite editor or IDE. Configure the command once in Preferences and the toolbar button does the rest.

+
From 402dcadb72817f8d78a44002c83e212368cc5f20 Mon Sep 17 00:00:00 2001 From: Paris Theofanidis Date: Sat, 16 May 2026 20:26:21 +0300 Subject: [PATCH 2/3] docs(site): document edit mode, images, links, external editor, window state Adds dedicated sections to the docs page covering the user-visible features that didn't have docs yet: how to enter edit mode and the full shortcut/menu vocabulary, image rendering (local + remote) with supported formats, link interactions (hover, click, right-click), external editor configuration, and window state persistence. Co-Authored-By: Claude Opus 4.7 (1M context) --- site/docs.html | 53 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/site/docs.html b/site/docs.html index 6a36ef1..d77518d 100644 --- a/site/docs.html +++ b/site/docs.html @@ -45,6 +45,59 @@

Live Reload

Multi-Window

Press Cmd+N to open a new window and view multiple files side by side. Each window independently tracks and live-reloads its own file.

+

Edit Mode

+

Press Cmd+E (or the Edit button in the toolbar) to toggle edit mode. The rendered document becomes editable in place — no separate textarea, no syntax view.

+

Each block (paragraph, heading, list, quote, code block) shows a handle on hover. Click the handle to open a menu that lets you convert the block to a different type, duplicate it, move it up or down, or delete it.

+

Formatting — with text selected:

+ + + + + + + + + + + +
ShortcutAction
Cmd+BBold
Cmd+IItalic
Cmd+Shift+XStrikethrough
Cmd+EInline code
Cmd+KLink
+

Navigation and structure:

+
    +
  • Enter splits the current block at the caret — the new block below gets focus
    • +
  • Shift+Enter inserts a line break inside the current block
    • +
  • ArrowUp / ArrowDown at the top or bottom of a block moves the caret to the adjacent block
    • +
  • Esc commits the edit and exits the block
    • +
+

Toggles:

+
    +
  • Cmd+/ drops the active block into a raw-markdown editor — useful for content the WYSIWYG editor can't represent (e.g. images, footnotes). The next click on the block returns to WYSIWYG.
    • +
  • Cmd+Shift+F toggles a small floating toolbar with buttons for the formatting actions above. Starts hidden each session.
    • +
+

Blocks containing inline content the editor can't faithfully round-trip (raw HTML, inline images, superscript, etc.) open in the raw-markdown editor automatically so the source is never silently changed.

+ +

Images

+

Inline images load directly in the rendered document:

+
    +
  • Local paths — relative (![](images/photo.png)) or absolute (![](/Users/you/Pictures/photo.png)) filesystem paths, served via a dedicated om-asset: protocol restricted to image file types
    • +
  • Remote URLs — https:// URLs are loaded by the renderer
    • +
+

Supported image formats: PNG, JPEG, GIF, SVG, WebP, AVIF, ICO, BMP.

+ +

Links

+

Links in rendered documents work the way you'd expect:

+
    +
  • Hover a link to see its target URL in the status bar
    • +
  • Click an HTTP/HTTPS link to open it in your default browser
    • +
  • Right-click for a menu with options to copy the URL or open it explicitly
    • +
+ +

External Editor

+

If you'd rather make heavier edits in your usual editor, configure an external editor command in Preferences → External Editor (for example, code for VS Code, cursor for Cursor, subl for Sublime). A button in the toolbar then opens the current file in that editor with one click.

+

Live reload picks up the changes as soon as you save in the external editor.

+ +

Window State

+

The app remembers each window's size, position, and fullscreen state. When you reopen Open Markdown, your windows come back exactly where they were.

+

Keyboard Shortcuts

From 0fe0de991fd0ad40259c0f8bb081df2c366ef931 Mon Sep 17 00:00:00 2001 From: Paris Theofanidis Date: Sat, 16 May 2026 20:26:54 +0300 Subject: [PATCH 3/3] docs(site): split shortcuts table into Global + Edit Mode Adds Cmd+E (toggle edit mode) and Cmd+S (save) to the global table, and a new Edit Mode table covering all the inline editor shortcuts: formatting (B/I/Shift+X/E/K), toggles (/, Shift+F), navigation (Enter, Shift+Enter, arrows), and commit (Esc). Co-Authored-By: Claude Opus 4.7 (1M context) --- site/docs.html | 27 ++++++++++++++++++++++++++- 1 file changed, 26 insertions(+), 1 deletion(-) diff --git a/site/docs.html b/site/docs.html index d77518d..e8dd7a0 100644 --- a/site/docs.html +++ b/site/docs.html @@ -99,6 +99,7 @@

Window State

The app remembers each window's size, position, and fullscreen state. When you reopen Open Markdown, your windows come back exactly where they were.

Keyboard Shortcuts

+

Global

@@ -109,12 +110,36 @@

Keyboard Shortcuts

+ + + - + +
Cmd+OOpen file
Cmd+NNew window
Cmd+WClose window
Cmd+SSave
Cmd+EToggle edit mode
Cmd+FFind in page
Cmd+TToggle light/dark theme
Cmd+=Zoom in
Cmd+-Zoom out
Cmd+0Reset zoom
Cmd+WClose window
+

In edit mode (with text selected, unless noted)

+ + + + + + + + + + + + + + + + + + +
ShortcutAction
Cmd+BBold
Cmd+IItalic
Cmd+Shift+XStrikethrough
Cmd+EInline code
Cmd+KInsert link
Cmd+/Toggle raw-markdown for the active block
Cmd+Shift+FToggle floating format toolbar
EnterSplit block at caret, focus the new block below
Shift+EnterInsert line break inside the current block
ArrowUp / ArrowDownCross to adjacent block at top/bottom edge
EscCommit and exit the active block