mdpreviewlisted

# mdpreview — Markdown Preview & Annotate Catppuccin Mocha/Latte live-reloading Markdown viewer with multi-tab support and Google Docs-style margin annotations. > **Canonical repo**: [github.com/tdimino/dabarat](https://github.com/tdimino/dabarat). Clone it or ensure `md_preview_and_annotate` is on your PYTHONPATH. ## Quick Start ```bash # Preview one or more files python3 -m md_preview_and_annotate file.md [file2.md ...] --port 3031 # If not installed globally, run from the cloned repo: python3 ~/Desktop/Programming/md-preview-and-annotate/md_preview_and_annotate/__main__.py file.md ``` ### Add a file to a running server ```bash python3 -m md_preview_and_annotate --add another.md --port 3031 ``` ### Add an annotation from CLI (no server needed) ```bash python3 -m md_preview_and_annotate --annotate file.md \ --text "RPL §235-b" --author "Claude" --comment "Cite the specific subsection" ``` This writes directly to the sidecar JSON (`file.md.annotations.json`). The live viewer picks it up on the next 500ms poll cycle. ## Features | Feature | Details | |---------|---------| | **Live reload** | 500ms polling, auto-refreshes on file save | | **Multi-tab** | Open multiple .md files, switch tabs, add/close at runtime | | **Tab reuse** | Launching a new file while the server is running adds it as a tab | | **Annotations** | Right-margin comment bubbles with author badges (human/AI) | | **Threaded replies** | Reply to any annotation inline | | **Bookmarks** | Global pers