Create a blank HedgeDoc note with the instance's default template content.

Useful for quickly starting a new note without providing content upfront. Returns the note ID and URL.

Create a new HedgeDoc note with a random ID.

• title: The title of the note (will be added as level-1 heading)

• content: The markdown body content Returns the note ID and URL. Note: HedgeDoc 1.x does not use API tokens. This tool works anonymously if the instance allows it (CMD_ALLOW_ANONYMOUS).

Create a new HedgeDoc note with a custom URL alias.

Requires HedgeDoc's FreeURL mode to be enabled on the instance (CMD_ALLOW_FREEURL=true).

• alias: The custom URL slug (e.g. 'my-diagram')

• title: The title of the note (will be added as level-1 heading)

• content: The markdown body content Returns the note ID and URL.

Create a HedgeDoc note with a Mermaid diagram.

HedgeDoc 1.x renders Mermaid natively in the editor.

• title: The title of the diagram note

• diagram_type: The Mermaid diagram type (e.g. 'graph TD', 'sequenceDiagram', 'flowchart LR', 'classDiagram', 'gantt', 'pie')

• diagram_code: The Mermaid diagram body (without the type header)

• description: Optional explanatory text before the diagram Returns the note ID and URL.

Read the raw markdown content of a HedgeDoc note.

• note_id: The note ID or alias (the slug from the URL)

Get metadata of a HedgeDoc note (title, description, timestamps, viewcount).

• note_id: The note ID or alias (the slug from the URL)

List all available revisions of a HedgeDoc note.

Each revision entry has an id (Unix timestamp) and a length (chars). The revision-id can be used with hedgedoc_get_revision to retrieve the full content of a specific revision.

• note_id: The note ID or alias (the slug from the URL) Returns a JSON array of revisions.

Get the full content and authorship of a specific revision.

• note_id: The note ID or alias (the slug from the URL)

• revision_id: The revision ID (Unix timestamp from hedgedoc_list_revisions) Returns JSON with the note content and authorship data at that revision.

Get the published (read-only) URL of a HedgeDoc note.

HedgeDoc's publish mode renders the note without the editor UI — ideal for sharing with viewers who should not edit the content.

• note_id: The note ID or alias (the slug from the URL) Returns the published URL.

Get the slide presentation URL of a HedgeDoc note.

HedgeDoc can render notes designed as slides (using slide breaks) into a full-screen presentation — useful for diagrams in meetings.

• note_id: The note ID or alias (the slug from the URL) Returns the slide URL.

Get the current status of the HedgeDoc instance.

Returns JSON with:

• note_count: Number of notes stored on the server

• online_users: Number of (distinct) online users

• Other instance metrics