# HackMD

**Canonical:** https://apis.io/providers/hackmd/  
**Website:** https://hackmd.io/  
**APIs profiled:** 8

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.

## Kin Score — 50.7 / 100 (developing)

Scored 2026-08-17 under rubric 0.11.0. Trend: flat (+0.0 from 50.7).

| Facet | Score |
|---|---|
| Discoverability | 81.5 |
| Contract Quality | 47.0 |
| Governance | 11.5 |
| Operational Transparency | 57.9 |
| Developer Ergonomics | 64.7 |
| Commercial Clarity | 44.7 |

## Agent readiness — 35.8 (agent-ready)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | no |
| MCP Server | derived |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | documented |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | derived |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Self-serve signup — onboarding: self-serve, pricing: unknown, trial: no (confidence: medium).

## APIs (8)

- **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.

## MCP servers (1)

- **hackmd-mcp.yml**

## Security (2)

- **Hackmd Authentication** — http · 1 scheme
- **Hackmd Domain Security** — TLSv1.2 · HSTS · DNSSEC · DMARC

## Tags

Company, Markdown, Collaboration, Documentation, Note Taking, Knowledge Base, Productivity, Content

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/hackmd/). Scores are computed from the provider's own public artifacts under a published rubric.