MkDocs website screenshot

MkDocs

MkDocs is a fast, simple, and beautiful static site generator designed for building project documentation from Markdown source files. Written in Python, it reads a single YAML configuration file (mkdocs.yml) and converts a directory of Markdown documents into a self-contained static HTML site. MkDocs supports multiple built-in themes (mkdocs, readthedocs), a rich plugin ecosystem via Python entry points, live-reloading development server, and one-command deployment to GitHub Pages.

MkDocs is profiled on the APIs.io network. Tagged areas include Documentation, Markdown, Open Source, Python, and Static Site Generator.

The MkDocs catalog on APIs.io includes 1 JSON-LD context and 1 Spectral governance ruleset.

MkDocs’ developer surface includes documentation, getting-started guide, GitHub presence, and 5 more developer resources.

🌐 Visit website 📡 Source on GitHub
22.6/100 emerging ▬ flat Agent 0/100 human only Full breakdown ↓
scored 2026-07-27 · rubric v0.5
0 APIs
DocumentationMarkdownOpen SourcePythonStatic Site Generator

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-27 · rubric v0.5
Composite quality — 22.6/100 · emerging
Contract Quality 2.4 / 25
Developer Ergonomics 3.9 / 20
Commercial Clarity 0.0 / 20
Operational Transparency 0.7 / 13
Governance 8.8 / 12
Discoverability 6.8 / 10
Agent readiness — 0/100 · human only
Machine-Readable Contract 0 / 18
Agentic Access Contract 0 / 15
MCP Server 0 / 12
Machine-Readable Auth 0 / 10
Idempotency 0 / 9
Stable Error Semantics 0 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 0 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/mkdocs: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Mkdocs Context

0 classes · 7 properties

JSON-LD

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

MkDocs API Rules

6 rules · 5 warnings 1 info

SPECTRAL

JSON Schema 2

Standalone JSON Schema definitions for this provider's data models.

MkDocs Configuration

30 properties

JSON SCHEMA

MkDocs Plugin

6 properties

JSON SCHEMA

Security Posture 1

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Mkdocs Domain Security

TLSv1.3

SECURITY

Resources

Get Started 1

Portal, sign-up, and the first successful call

GettingStarted
GettingStarted

Documentation 3

Reference material describing how the API behaves

Documentation
Documentation
 JSONSchema
JSONSchema
 JSONSchema
JSONSchema

Design & Contract 1

Pagination, idempotency, versioning, errors, and events

JSONLD
JSONLD

Build 1

SDKs, sample code, and the tooling you integrate with

GitHub
GitHub

Access & Security 1

Authentication, authorization, and security posture

DomainSecurity
DomainSecurity

Company 1

The organization behind the API

Website
Website

Source (apis.yml)

apis.yml Raw ↑ 
aid: mkdocs
name: MkDocs
description: MkDocs is a fast, simple, and beautiful static site generator designed for building project documentation from
  Markdown source files. Written in Python, it reads a single YAML configuration file (mkdocs.yml) and converts a directory
  of Markdown documents into a self-contained static HTML site. MkDocs supports multiple built-in themes (mkdocs, readthedocs),
  a rich plugin ecosystem via Python entry points, live-reloading development server, and one-command deployment to GitHub
  Pages.
type: Index
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  source: []
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/mkdocs.png
tags:
- Documentation
- Markdown
- Open Source
- Python
- Static Site Generator
url: https://raw.githubusercontent.com/api-evangelist/mkdocs/refs/heads/main/apis.yml
created: '2026-03-18'
modified: '2026-04-28'
specificationVersion: '0.20'
apis: []
common:
- type: DomainSecurity
  url: security/mkdocs-domain-security.yml
- type: Website
  url: https://www.mkdocs.org
- type: Documentation
  url: https://www.mkdocs.org/user-guide/
- type: GettingStarted
  url: https://www.mkdocs.org/getting-started/
- type: GitHub
  url: https://github.com/mkdocs/mkdocs
- type: JSONSchema
  url: json-schema/mkdocs-config-schema.json
- type: JSONSchema
  url: json-schema/mkdocs-plugin-schema.json
- type: JSONLD
  url: json-ld/mkdocs-context.jsonld
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com