API & MCP

Everything a person can do on Wikinest Markdown to HTML, a program or AI agent can do with the same inputs and get the identical result.

HTTP API

POST https://wikinestmarkdowntohtml.usefulweb.app/api/v1/calculate – run Wikinest Markdown to HTML
GET https://wikinestmarkdowntohtml.usefulweb.app/api/v1/tool – inputs, output schema, examples
OpenAPI 3.1: /openapi.json · /openapi.yaml
Errors: application/problem+json; 422 includes per-field errors.

Wikinest Markdown to HTML

Converts a Wikinest page written in Markdown into sanitised HTML: headings with anchors, tables, task lists, highlighted code, info/success/warning/error panels, expand sections, status lozenges, dates, mentions, [[page links]] and the table-of-contents and child-pages macros. It reports the outline, links that point nowhere and unsafe addresses it dropped.

Inputs of Wikinest Markdown to HTML
Field	Type	Default	Description
`markdown`	textarea	—	Page in Markdown. Wikinest Markdown: CommonMark and GitHub tables/task lists plus [[Page]] links, :::info panels, {status:green\|Done}, {date:2026-11-24}, {{toc}} and {{children}}.
`pageTitles`	textarea	—	Existing page titles (optional, one per line). [[Links]] to these titles become links to <slug>.html; others are marked as missing pages.
`children`	textarea	—	Child pages for {{children}} (optional, one per line)
`tocLevels`	integer	3	Headings in the outline down to level
`standalone`	boolean	false	Whole HTML document with a stylesheet (light and dark)

Example request

Runbook with panels, a table, code and task lists

curl -X POST https://wikinestmarkdowntohtml.usefulweb.app/api/v1/calculate -H 'content-type: application/json' -d '{"markdown":"# Runbook: api\n\n{status:green|Active} · Owner: @[Grace Hopper] · Last reviewed {date:2026-11-24}\n\n{{toc}}\n\n## Alerts\n| Alert | Meaning | First step |\n| --- | --- | --- |\n| High error rate | More than 2 % of requests fail | Check the latest deploy |\n\n## Diagnosis\n1. Check the [[Dashboards]] page\n2. Read the logs:\n\n```sh\njournalctl -u api --since \"15 min ago\"\n```\n\n:::warning Before you restart\nTell the on-call channel first. See [[Escalation]].\n:::\n\n## Recovery\n- [x] Restart the service\n- [ ] Write the incident note\n\n:::expand Older notes\nMoved from the old wiki.\n:::\n","pageTitles":"Dashboards\nOn-call rota","tocLevels":2}'

Every result contains

inputs (normalised, defaults applied), summary, result (validated against the published schema), units, assumptions, sources, warnings, computedAt and links.

MCP (Model Context Protocol)

Streamable HTTP endpoint: https://wikinestmarkdowntohtml.usefulweb.app/mcp – protocol revisions 2026-07-28 (stateless) and 2025-11-25 / 2025-06-18 / 2025-03-26 (initialize handshake).
Tools: wikinest_markdown_to_html
Local stdio connector: node src/mcp-stdio.ts --tool=wikinest-markdown-to-html

{
  "mcpServers": {
    "wikinest-markdown-to-html": { "type": "http", "url": "https://wikinestmarkdowntohtml.usefulweb.app/mcp" }
  }
}