HackMD
HackMD is a real-time collaborative Markdown editor and knowledge base for individuals and teams. Multiple people can co-edit a Markdown document live, organize notes into folders and team workspaces, and publish them as web pages, slide decks or books. HackMD exposes a v1 REST API at api.hackmd.io that lets developers programmatically create, read, update and delete personal and team notes, manage folders and folder ordering, upload image attachments, restore notes from trash, and read the current user profile and view history. The API authenticates with a personal access token sent as an HTTP bearer credential, is described by a published OpenAPI 3.0 specification and Swagger UI, ships an official Node.js/TypeScript client (@hackmd/api) and command-line interface, and advertises its full developer surface through an RFC 9727 api-catalog. HackMD is a Techstars-backed company.
HackMD publishes 12 API contracts indexed on the APIs.io network, including History API, Profile API, Team Folders API, and 9 more. Tagged areas include Company, Markdown, Collaboration, Documentation, and Note Taking.
The HackMD catalog on APIs.io includes 1 Spectral governance ruleset.
HackMD’s developer surface includes documentation, API reference, getting-started guide, engineering blog, pricing, signup flow, changelog, and 26 more developer resources.
What this lets a business do 1
Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →
Kin Score
Markets this provider is in provisional
The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.
| Market | Position | Depth | Registered MCP server | Declares compatibility |
|---|---|---|---|---|
| Agent Skills (SKILL.md packages) | builds-on | 24.9 | - | 1 |
| Obsidian Community Plugins (third-party APIs the Obsidian plugin ecosystem integrates) | builds-on | 24.9 | - | 1 |
Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards implemented 2
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
APIs 12
Individual APIs this provider publishes, each with its own machine-readable definition.
HackMD History API
Operations related to user's note history.
HackMD Profile API
Operations to retrieve user profile information.
HackMD Team Folders API
Operations related to folders within a team.
HackMD Team Notes API
Operations related to notes within a team.
HackMD Teams API
Operations related to user teams.
HackMD Trash API
Operations for listing and restoring trashed notes.
HackMD User Folders API
Operations related to a user's personal folders.
HackMD User Notes API
Operations related to a user's personal notes.
HackMD Comments API
Operations for reading and resolving note comments.
HackMD Team Webhooks API
Operations for managing webhooks in a team workspace.
HackMD Versions API
Operations for listing, retrieving, comparing, creating, and updating note versions.
HackMD Webhooks API
Operations for managing webhooks in a personal workspace.
Scroll for all 12
Open Collections 8
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
HackMD Open History API
OPEN COLLECTIONHackMD Open History Profile API
OPEN COLLECTIONHackMD Open History Team Folders API
OPEN COLLECTIONHackMD Open History Team Notes API
OPEN COLLECTIONHackMD Open History Teams API
OPEN COLLECTIONHackMD Open History Trash API
OPEN COLLECTIONHackMD Open History User Folders API
OPEN COLLECTIONHackMD Open History User Notes API
OPEN COLLECTIONScroll for all 8
Agent Skills 3
Packaged agent skills for driving this provider's APIs from an AI assistant.
Create and publish a HackMD note
AGENT SKILLManage HackMD team notes
AGENT SKILLOrganize HackMD notes with folders
AGENT SKILLHackMD API pricing
Prices published by HackMD, read 2026-10-28 from hackmd.io/pricing.
| Plan | Price |
|---|---|
| Free | $0 Includes: Unlimited notes, 3 invitees, 3 custom templates, 20 GitHub pushes per month, up to 1MB per image, 40 |
| Prime | $5 per seat/mo Includes: Full-text search, up to 20MB per image, PDF export, unlimited invites/versions/GitHub pushes/custom |
| Enterprise | Request a demo -> Includes: Everything in Prime, plus RBAC, SSO, custom domain, GitLab integration, self-hosting, dedicated acco |
Plan details, limits and sources →
Billed by: team · FinOps profile →
Pricing Plans 2
Published pricing tiers and plan structures.
Hackmd Plans Pricing
PLANSRate Limits 1
Documented rate limits and quota policies.
Hackmd Rate Limits
RATE LIMITSService Levels 1
Uptime the provider promises or reports, as SLA4OAI. Read from its own pages; APIs.io runs no monitors.
HackMD
SLAFinOps 1
Cost, billing, and metering signals for API financial operations.
Hackmd Finops
FINOPSSpectral Rules 1
Spectral governance rulesets for linting and validating these APIs.
HackMD API Rules
SPECTRALOpenAPI Overlays 1
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
Hackmd Openapi Overlay
DERIVEDSecurity Posture 2
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Resources
Get Started 3
Portal, sign-up, and the first successful call
Documentation 3
Reference material describing how the API behaves
Agent Surfaces 4
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 5
Pagination, idempotency, versioning, errors, and events
Build 4
SDKs, sample code, and the tooling you integrate with
Access & Security 2
Authentication, authorization, and security posture
Operate 3
Status, limits, changes, and where to get help
Commercial 4
Pricing, plans, and the legal terms of use
Company 2
The organization behind the API
Other 3
Properties that don't map to a standard resource type
Source (apis.yml)
HackMD API — frequently asked questions
Does HackMD have an API?
Yes. APIs.io lists 12 APIs from HackMD, including HackMD History API, HackMD Profile API and HackMD Team Folders API, and 9 more.
Is there an OpenAPI specification for the HackMD API?
Yes. APIs.io indexes 12 OpenAPI specifications for HackMD, each linked for download from this page.
How do I authenticate with the HackMD API?
HackMD uses bearer-token authentication (http · 1 scheme). The details are profiled on APIs.io as Hackmd Authentication.
How much does the HackMD API cost?
HackMD publishes its prices; its Free plan is $0 as of 2026-10-28. APIs.io lists 3 pricing plans for HackMD, with each plan's price, limits and inclusions under Pricing on this page.
Is the HackMD API ready for AI agents?
HackMD has a Kin Score of 61.3 out of 100 (strong) and an Agent Readiness score of 32.1 (agent-ready), scored by API Evangelist on 2026-11-06.
Work with this as data
Every provider here is available over the APIs.io API and to AI agents over MCP.