Guide and feedback for the review loop.

Start with the concepts that make wowMD different: typed review, cross-version survival, reviewed Markdown for Obsidian, and the ticket you can hand to an AI.

Open Markdown without changing the original

Open local .md or .markdown files by picker or drag-and-drop, or continue from supported public GitHub Markdown through the extension.

Source-safe review happens in the browser and never writes back to the original. Save reviewed copy creates a separate Obsidian-ready .md successor and carries annotations forward.

Version history lets you reopen browser-local successors created from the current document lineage.

Version history
Version history explaining reviewed copies and source-safe successors

Typed review: four judgments, not just colors

When you mark text in wowMD, you record a judgment with an implied action. These types drive the Notes panel, the Overall Review Map, and the Ticket JSON legend.

Clarify neededExplain or clarify this point without changing its substance.
DisputedReview this claim; it may be incorrect and may need correction.
ImportantKeep and emphasize this key point.
ConfirmedReviewed and correct; no action needed.

Cross-version survival

When the source document changes, wowMD tries to re-anchor your annotations to the same passage using the selected quote and surrounding context. If a passage truly disappears, the mark becomes orphaned and can be recovered manually with Find.

Re-anchoring is non-destructive. wowMD recalculates annotation positions; it does not write back to the source file.

Ticket JSON: your judgments as an AI work order

A ticket bundles the document snapshot, a bilingual type legend, section context, selected quotes, notes, and suggested replacements. It is different from Backup JSON, which stores raw annotations for backup and re-import.

  1. Click
  2. Open your AI tool of choice.
  3. Paste the prompt below, then paste the ticket contents.
You are a careful Markdown document editor. I will give you a wowMD Ticket JSON.

Use ticket.document.markdownSnapshot as the only source draft. Read and obey ticket.executionContract, ticket.sections, ticket.confirmedZones, and ticket.lineageOutput when present.

Rules:
1. Process every item in ticket.tickets by id and sequence.
2. Use ticket.typeLegend and ticket.executionContract.typeOperations as the authoritative meaning of each type.
3. Locate each item by headingPath, sectionBody, quote, prefix, and suffix. If a location is ambiguous or missing, leave it unchanged and report it as unresolved.
4. Preserve unannotated content exactly unless ticket.executionContract explicitly allows a supporting local edit.
5. Prefer suggestedReplacement when present. Use note as reviewer intent, not as text to paste unless it clearly asks for wording.
6. If ticket.lineageOutput is present, append the requested wowMD document-meta block at the end. Omit bodyHash unless you can calculate it correctly.

Output:
First output the complete revised Markdown without omitting unchanged sections. Then output a short change list keyed by ticket id and sequence.

Ticket JSON:
<paste the exported Ticket JSON here>

Storage, backup, and recovery

Saved annotations and imported GitHub document copies use browser site data, not ordinary browser cache. Local files remain session inputs; wowMD stores their annotations by document fingerprint.

Clearing site data, private browsing, another browser, profile, or device, and storage eviction can remove browser-local work. Unsaved toolbar drafts can also be lost after refresh or crash.

Export Backup JSON for re-importable annotation data, Reviewed Markdown for human-readable review context, and finished delivery artifacts for long-term safekeeping.

Choose the task. Follow the review path.

Each workflow connects a real source, the right review actions, where to focus, and the best delivery artifact.

Developer reading an open-source READMEFind setup commands, APIs, limitations, and warnings quickly.
  1. 01Open with the Chrome extension
  2. 02Navigate outline and fold sections
  3. 03Inspect commands, code, and tables
  4. 04Continue in Pro only when deeper review is needed
Best outcomeFast structured reading, with no export required

Reader

Reader
wowMD reader with outline, Markdown document, and notes panel

Outline adapts to long heading titles, tracks your scroll position, and jumps to headings.

Fold

Search

Code, tables, theme, and font size

Annotate

Annotate
Typed review highlights and notes panel with ticket export

Selection toolbar

Notes stay linked to the passage and can include a suggested replacement without changing the source.

Filter by type

Overall Review Map

See section coverage, review confidence, risk focus, typed annotation distribution, and the sections that need attention next.

Overall Review Map
Overall Review Map showing coverage, review confidence, risk focus, and sections needing attention

Export

Export
Export workspace with HTML preview and include options

HTML export is for people: one offline-readable file with structure, highlights, and notes.

Reviewed Markdown is for Obsidian: a new .md copy with review callouts, tags, and properties. It does not edit the original or apply suggested replacements.

Backup JSON is for backup and re-import: raw annotation data.

Ticket JSON is for AI or an editor: a work order built from your typed judgments.

Settings

Settings
Settings panel with notes panel and annotation display preferences

Choose whether the Notes panel slides out on demand or stays visible as a sidebar.

Choose light highlights or underline plus margin notes for annotation display.

Preferences are stored locally in this browser.

Feedback

Use this section for bugs, confusing wording, missing guide material, or workflow requests.

FAQ and troubleshooting

wowMD re-anchors annotations when the source changes. If a passage cannot be found, use Find from the Notes panel to recover it manually.

No. The review workflow is local-first. Files and annotations stay in your browser unless you export and share them yourself.

No. Saved annotations and imported document copies use browser site data. Export Backup JSON and finished review artifacts before clearing site data or moving to another browser, profile, or device.

Use HTML for people, Reviewed Markdown for Obsidian, Backup JSON to back up or re-import annotation data, and Ticket JSON when you want an AI or editor to act on your typed judgments.