Inline Popups

VMark provides contextual popups for editing links, images, math, footnotes, and more. These popups work in both WYSIWYG and Source modes with consistent keyboard navigation.

Common Keyboard Shortcuts

All popups share these keyboard behaviors:

Action	Shortcut
Close/Cancel	Escape
Confirm/Save	Enter
Navigate fields	Tab / Shift + Tab

Link Tooltip & Popup

VMark uses a two-tier system for links: a read-only tooltip on hover, and an edit popup via keyboard shortcut.

Hover Tooltip (Read-Only)

Trigger: Hover over link (300ms delay)

Shows:

• URL preview — Truncated URL with full URL on hover
• Open button — Opens link in browser (or jumps to heading for #bookmarks)

Behavior: View-only. Move mouse away to dismiss.

Edit Existing Link

Trigger: Place cursor in link + Mod + K

Fields:

• URL — Edit the link destination
• Open — Open link in browser
• Copy — Copy URL to clipboard
• Delete — Remove link, keep text

Create New Link

Trigger: Select text + Mod + K

Smart clipboard: If your clipboard contains a URL, it's auto-filled.

Fields:

• URL input — Enter destination
• Confirm — Press Enter or click ✓
• Cancel — Press Escape or click ✗

Source Mode

• Cmd + Click on link → opens in browser
• Click on [text](url) syntax → shows edit popup
• Mod + K inside link → shows edit popup

Bookmark Links

Links starting with # are treated as bookmarks (internal heading links). Open jumps to the heading instead of opening a browser.

Image Tooltip & Popup

VMark uses a two-tier system for images: a read-only tooltip on hover, and an edit popup on click.

Hover Tooltip (Read-Only)

Trigger: Hover over image (300ms delay)

Shows:

• Filename — Truncated name with full path on hover
• Dimensions — Image width × height in pixels
• Reveal button — Opens image location in Finder

Behavior: View-only. Move mouse away to dismiss.

Edit Popup

Trigger: Click on image

Fields:

• Source — Image URL or local path
• Alt Text — Accessibility description
• Dimensions — Read-only display (e.g., "800 × 600 px")

Buttons:

• Browse — Pick image from filesystem
• Copy — Copy source path
• Toggle — Switch between inline and block image
• Delete — Remove image

Shortcuts:

• Mod + Shift + I — Insert new image

Math Popup

Edit LaTeX math expressions with live preview.

Trigger:

• WYSIWYG: Click on inline math $...$

Fields:

• LaTeX Input — Edit the math expression
• Preview — Real-time rendered preview
• Error Display — Shows LaTeX errors with helpful syntax hints

Shortcuts:

• Mod + Enter — Save and close
• Escape — Cancel and close
• Shift + Backspace — Delete inline math (works even when non-empty)
• Alt + Mod + M — Insert new inline math

Error Hints

When you have a LaTeX syntax error, the popup shows helpful suggestions like missing braces, unknown commands, or unbalanced delimiters.

Source Mode

In Source mode, edit math directly in the text. The preview appears in the Mermaid/Math preview panel.

Footnote Popup

Edit footnote content inline.

Trigger:

• WYSIWYG: Hover over footnote reference [^1]

Fields:

• Content — Multi-line footnote text (auto-resizing)
• Go to Definition — Jump to footnote definition
• Delete — Remove footnote

Behavior:

• New footnotes auto-focus the content field
• Textarea expands as you type

Wiki Link Popup

Edit wiki-style links for internal document connections.

Trigger:

• WYSIWYG: Hover over [[target]] (300ms delay)
• Source: Click on wiki link syntax

Fields:

• Target — Workspace-relative path (.md extension handled automatically)
• Browse — Pick file from workspace
• Open — Open linked document
• Copy — Copy target path
• Delete — Remove wiki link

Table Context Menu

Quick table editing actions.

Trigger:

• WYSIWYG: Use toolbar or keyboard shortcuts
• Source: Right-click on table cell

Actions:

Action	Description
Insert Row Above/Below	Add row at cursor
Insert Column Left/Right	Add column at cursor
Delete Row	Remove current row
Delete Column	Remove current column
Delete Table	Remove entire table
Align Column Left/Center/Right	Set alignment for current column
Align All Left/Center/Right	Set alignment for all columns
Format Table	Auto-align table columns (prettify markdown)

Spell Check Popup

Fix spelling errors with suggestions.

Trigger:

• Right-click on misspelled word (red underline)

Actions:

• Suggestions — Click to replace with suggestion
• Add to Dictionary — Stop marking as misspelled

Mode Comparison

Element	WYSIWYG Tooltip	WYSIWYG Edit	Source
Link	Hover (read-only)	Mod+K	Click / Mod+K / Cmd+Click to open
Image	Hover (read-only)	Click	Mod+Shift+I
Math	—	Click	Direct edit
Footnote	Hover	—	Direct edit
Wiki Link	Hover	—	Click
Table	—	Toolbar	Right-click menu
Spell Check	—	Right-click	Right-click

Popup Navigation Tips

Focus Flow

1. Popup opens with first input focused
2. Tab moves forward through fields and buttons
3. Shift + Tab moves backward
4. Focus wraps within popup

Quick Editing

• For simple URL changes: edit and press Enter
• For canceling: press Escape from any field
• For multi-line content (footnotes, math): use Mod + Enter to save

Mouse Behavior

• Click outside popup to close (changes are discarded)
• Hover popups (link, footnote, wiki) have 300ms delay before showing
• Moving mouse back to popup keeps it open