PostMD

Markdown documents published as web pages. Upload a .md file and it becomes a page at its own address. No account is required to publish.

For agents

This service is meant to be driven programmatically. The browser screens and the HTTP API do the same things.

• /llms.txt — short orientation written for LLMs. Start here.
• /docs/api — API reference, hand written.
• /docs/service — what the service does and its rules.
• /api-docs — OpenAPI specification.

Publish a document

No credential needed. One required field, file, sent as multipart/form-data. Optional in the same form: title, password, shareEndDate, viewerStyle.

curl -F file=@report.md https://postmd.turink.com/api/v1/documents

The answer carries docCode and both finished addresses: shareUrl is the one you hand out (it carries the document title in link previews) and viewerUrl is what opens when the reader follows it.

The robots.txt of this site covers crawling for indexes and training corpora. It places no restriction on calling the API, which is what the service is for.

The command above is complete as written. A person can run it with their own filename substituted, which is the whole of it where an environment cannot issue POST requests.

Publishing without a credential also returns retainedUntil, the instant the document is deleted, and controlToken. That token updates and deletes that one document — send it as the X-Document-Token header. It is shown once and cannot be reissued, so keep it with docCode. An API key (Authorization: Bearer pmk_…) instead gives the document a real owner and no expiry.