md-annotator 0.6.0 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +12 -5
- package/client/dist/index.html +626 -442
- package/package.json +3 -1
- package/server/config.js +18 -0
- package/server/feedback.js +18 -2
- package/server/routes.js +2 -1
package/README.md
CHANGED
|
@@ -21,6 +21,8 @@
|
|
|
21
21
|
- **Multi-File Support** -- Review multiple files in one session with a tabbed interface
|
|
22
22
|
- **Linked Navigation** -- Click relative `.md` links to open them as new tabs (wiki-style browsing)
|
|
23
23
|
- **Mermaid Diagrams** -- Renders `mermaid` code blocks as interactive diagrams with zoom, pan, and source toggle (adapts to light/dark theme)
|
|
24
|
+
- **PlantUML Diagrams** -- Renders `plantuml` code blocks as SVG via a configurable PlantUML server with zoom, pan, and source toggle
|
|
25
|
+
- **Kroki Diagrams** -- Renders 27+ diagram formats (`graphviz`, `d2`, `ditaa`, `erd`, `nomnoml`, `excalidraw`, and more) via a configurable [Kroki](https://kroki.io) server
|
|
24
26
|
- **File References** -- Type `@` in comments to autocomplete and reference other project files
|
|
25
27
|
- **Export & Import** -- Export annotations as Markdown or JSON; re-import JSON to continue a review later
|
|
26
28
|
- **Annotation Persistence** -- Annotations auto-save to the server and survive page reloads (validated by content hash)
|
|
@@ -129,10 +131,15 @@ The server starts on an available port (default 3000) and opens your browser aut
|
|
|
129
131
|
|
|
130
132
|
### Environment Variables
|
|
131
133
|
|
|
132
|
-
| Variable
|
|
133
|
-
|
|
134
|
-
| `MD_ANNOTATOR_PORT`
|
|
135
|
-
| `MD_ANNOTATOR_BROWSER` | Custom browser application
|
|
134
|
+
| Variable | Description |
|
|
135
|
+
|------------------------|--------------------------------------------------------------|
|
|
136
|
+
| `MD_ANNOTATOR_PORT` | Override the server port (default: 3000) |
|
|
137
|
+
| `MD_ANNOTATOR_BROWSER` | Custom browser application |
|
|
138
|
+
| `PLANTUML_SERVER_URL` | PlantUML render server (default: `https://www.plantuml.com/plantuml`) |
|
|
139
|
+
| `KROKI_SERVER_URL` | Kroki render server (default: `https://kroki.io`) |
|
|
140
|
+
|
|
141
|
+
> [!NOTE]
|
|
142
|
+
> **Privacy**: When rendering PlantUML or Kroki diagrams, the diagram source is encoded and sent to the configured server. The defaults are the public servers at `plantuml.com` and `kroki.io`. If your documents contain sensitive diagrams, self-host a [PlantUML server](https://hub.docker.com/r/plantuml/plantuml-server) or [Kroki server](https://docs.kroki.io/kroki/setup/install/) and set `PLANTUML_SERVER_URL` / `KROKI_SERVER_URL` accordingly.
|
|
136
143
|
|
|
137
144
|
## 📝 How It Works
|
|
138
145
|
|
|
@@ -143,7 +150,7 @@ Once a file is opened in the browser, you can:
|
|
|
143
150
|
- **Comment** -- highlights text (yellow) and adds a comment
|
|
144
151
|
- **Insert** -- place the cursor to add new text at that position
|
|
145
152
|
- **Global Comment** -- add general feedback via the "+" button in the annotation panel
|
|
146
|
-
- **Annotate images & diagrams** -- click on images or
|
|
153
|
+
- **Annotate images & diagrams** -- click on images, Mermaid, PlantUML, or Kroki diagrams to comment or delete them
|
|
147
154
|
- **View annotations** in the sidebar panel on the right
|
|
148
155
|
- **Export** annotations as Markdown or JSON
|
|
149
156
|
- **Approve** or **Submit Feedback** when done
|