The HackMD Versions API is now live 🕘

No dark-mode styles — this email renders the same in a dark client.

Five new endpoints let your integrations and agents see how a document changed, not just what it says now.  

HackMD ( https://hackmd.io/?nav=overview )

***********************
The HackMD Versions API
is now live!
***********************

 

Hey nseemre!

Your team’s documents live on HackMD, and they change constantly. Until now, anything you built on top of HackMD could see a note’s current content and almost nothing about how it got there.

The Versions API is now live in production at https://api.hackmd.io/v1 ( https://api.hackmd.io/v1/docs?_gl=1*ixjc22*_ga*ODA2OTg0MDczLjE3NzY3NzUwMTE.*_ga_NGVZMM6DR6*czE3ODg5NjQ2MzAkbzExMSRnMSR0MTc4ODk2NzA3MiRqNDUkbDEkaDE2MzkyNDg2MzM. ), with five operations under /notes/{noteId}/versions.

Terminal panel showing a GET request to the versions endpoint returning a list of named versions

What’s new in this release:

* List and search a note’s version history, filtered by named versions, free text, or creator.
* Read any saved version’s metadata and content.
* Compare two saved versions, or a saved version against current note content, as a unified diff.
* Name a version as a document milestone, and update its metadata.

Terminal panel showing a unified diff between a named version and current note content

For most HackMD users, nothing changes today. Version history in the editor behaves exactly as it did. What is new is the programmatic route.

------------------------
Ready to start building?
------------------------

You need a HackMD API token and a note ID, the same authentication the rest of the API uses. Head over to the Developer Portal to generate your access token and view the updated documentation.

Developer Portal ( https://hackmd.io/developers?utm_source=home&utm_medium=nav-bar )

💡 Integration Tip for Developers: a named version is a marker, not an approval. It carries no permission and records no sign-off, so don’t treat it as a review gate.

On free workspaces, content is readable for the 10 most recent versions. Older versions still appear in listings, marked as content-unavailable. Version names are not subject to that limit.

Our Model Context Protocol (MCP) server and hackmd-cli do not expose these endpoints yet.

Happy Hacking,

The HackMD Team

 

FOLLOW US

facebook ( https://www.facebook.com/hackmdio/ )
x ( https://x.com/hackmdio )
linkedIn ( https://www.linkedin.com/company/hackmd/ )

 

Click here to unsubscribe. ( https://track.customer.io/unsubscribe/dgTRggwDAJ7rU53rUwGgkn32Bvi1aVbXW0jIFGU= )

651 N Broad St, Suite 201
Middletown, New Castle County
Delaware 19709

Accession

nse/hackmd/2026-09-11/1299

From

HackMD Team · hello@newsletter.hackmd.io

Sent

11 September 2026 · 22:00 UTC