# HTML Docs

> Create, publish, edit, review, and collaborate on HTML documents and sites.

HTML Docs turns HTML or Markdown into a live hosted page. Pages can then be edited in the browser with region-level edits, comments, version history, real-time collaboration, PDF export, webhooks, and multi-page site publishing.

## Start here

- API discovery: https://www.html-docs.com/api/v1/help
- Full API reference: https://www.html-docs.com/developers
- Agent skill: https://www.html-docs.com/agents/skill.md
- Agent installation guide: https://www.html-docs.com/agents

## Fastest publish workflow

POST HTML, Markdown, or JSON to https://www.html-docs.com/api/v1/docs. No account or API key is required for an anonymous publish. The response contains { id, url, editUrl, token }. The url is public; keep token private because it authorizes later updates.

Example:
curl -sS -X POST https://www.html-docs.com/api/v1/docs -H 'Content-Type: text/html' --data-binary @page.html

Use X-Slug: my-page to request a custom public URL slug. Authenticated agents can send Authorization: Bearer hdk_... and manage account-owned documents, folders, sites, webhooks, and versions.

## Core API operations

- POST /api/v1/docs — create and publish from HTML or Markdown.
- GET, PUT, PATCH /api/v1/docs/:id — read or replace document content.
- PATCH /api/v1/docs/:id/regions/:regionKey — update one editable region while preserving comment anchors.
- Comments, versions, PDF export, activity, webhooks, search, folders, and multi-page sites are documented at /api/v1/help.

## Browser agents

On WebMCP-capable browsers, this site exposes the publish_html_docs_page tool. It accepts html_content and optional title and slug, then returns the live URL, editor URL, and update token.