The docs framework
you actually own.

Everything Scalar and Mintlify do — first-class OpenAPI, a live playground, instant search, and AI on your own key — open source and self-hostable. No SaaS. No seats. No lock-in.

markline — zsh — 80×24
// WORKS WITH WHAT YOU ALREADY SHIP
OpenAPI 3.1MarkdownMDXReactVercelNetlifyCloudflareDocker
1×
One command to ship
npx create-markline
0
Vendor lock-in
your repo, your host
100%
Static output
deploy anywhere
MIT
Open source license
fork it forever

This is the API reference.
Generated from your OpenAPI. Hosted by you.

Point Markline at an openapi.json and it builds a three-pane reference with a working request explorer and copy-paste samples in every language — no dashboard, no proxy, no per-call billing.

docs.acme.dev/reference
Core / Payments
POST Create payment
POST https://api.acme.dev/v1/payments

Creates a payment and returns the resulting object. Idempotent on Idempotency-Key.

Body parameters
amountrequired
integer
Amount in the smallest currency unit.
currencyrequired
string · ISO 4217
Three-letter currency code.
customer
string
ID of the customer to charge.
metadata
object
Set of key-value pairs.
Try it
cURLJSPythonGo
# request curl -X POST \ https://api.acme.dev/v1/payments \ -H "Authorization: Bearer ••••" \ -d '{ "amount": 2400, "currency": "usd" }'
200 OK 42 ms
{ "id": "pay_3Nk…", "status": "succeeded" }
Live in every Markline build · paired light & dark11 named themes · your CSS variables

Everything they do.
Fully open.

The features that made hosted docs platforms worth paying for — rebuilt as a framework you run yourself.

# openapi.json → reference
POST /v1/payments ✓ generated
GET /v1/payments/{id} ✓ generated
DEL /v1/payments/{id} ✓ generated

OpenAPI, done right

Drop in a spec and get a full three-pane reference — endpoints, schemas, auth, and a request explorer — regenerated on every build.

Try-it playground

Real requests, right in the page. Auth, variables, and responses — no Postman round-trip.

Instant static search

A prebuilt index ships with your site. Fast, offline-capable, zero services to run.

Self-host anywhere

Static output to any CDN, your own box, or a single Docker image. Your data never leaves.

Theme is a feature

CSS-variable design tokens, 11 named presets, and real light/dark — branded without forking.

Components & MDX

Callouts, tabs, code groups, and your own React components — inline in Markdown.

Bring your own key.
We bring the engine.

Markline ships the AI layer the hosted platforms meter — Ask-AI answers, Copy-for-LLM, llms.txt, semantic search — wired straight to your provider. Your key, your data, your bill. Nothing routes through us.

Ask AI

Natural-language answers grounded in your docs, with citations back to the source page.

Copy for LLM

One click turns any page into clean, prompt-ready context for your own model.

llms.txt & Markdown

Machine-readable docs by default — every page available as raw Markdown and an llms.txt index.

Semantic search

Embeddings-based search that matches meaning, not just keywords — generated at build time.

Bring your own key
OpenAI Anthropic Mistral Ollama · local Azure
How do I deploy to my own server?ESC
Run markline build to emit a static ./dist, then serve it with any web server or the bundled Docker image. No runtime services are required — the search index and API reference are prebuilt.
01 Deployment → Self-hosting02 Deployment → Docker
Answered by your model · BYOK · 0 tokens billed to Markline

Markline vs the SaaS docs platforms

Scalar and Mintlify are excellent — and they're services. The difference isn't features. It's who holds the keys.

CapabilityMarklineScalarMintlify
Open source (MIT)core
Self-host anywherepartial
No vendor lock-inpartial
No seat / page pricing
First-class OpenAPI reference
Interactive request playground
Static search, no serviceshostedhosted
Light / dark + themeable tokenspartial
AI answers on your own key (BYOK)metered
Copy-for-LLM · llms.txt · Markdownpartial
You own the data & the build

// Reflects publicly documented capabilities · June 2026 · corrections welcome via PR.

Run by the people who read the source

No logo wall yet — just an open repo, a permissive license, and sites already shipping on Markline.

markline-dev/markline
4,212
stars · growing every week
128contributors
MITlicense
v1.4latest
Star on GitHub
[ product shot ]
markline.dev — home, dark
Markline.dev self-hosted
[ product shot ]
API reference, light theme
Acme API docs /reference
[ product shot ]
SDK guide — three-pane
Tomoul SDK docs site
[ product shot ]
changelog + versioning
Hyphen changelog

Own your docs.

One command to scaffold. One repo to keep. Zero services to depend on.

$npx create-markline@latest