For AI agents: a documentation index is available at /llms.txt — every docs page also has a markdown twin (append .md to the page URL).
MkDocs → PDF with makesPDF
Render every MkDocs page to a sibling PDF via the makesPDF hosted API — one billed POST /api/v1/md render per page, dropped next to the HTML output (docs/guide.md → site/guide.pdf).
The integration ships as the mkdocs extra of the single makespdf PyPI package — there is no separate plugin project to install. Docusaurus sites use the sibling @makespdf/docusaurus-plugin; Hugo sites use the Hugo recipe.
Setup
pip install "makespdf[mkdocs]"
export MAKESPDF_API_KEY=... # mint at https://makespdf.com/settings/api-keys?ref=mkdocs-plugin# mkdocs.yml
plugins:
- search
- makespdf
extra:
makespdf: { pageSize: A4 } # optional; forwarded as /md `options`Build normally — mkdocs build now also writes the PDFs.
Using a hooks file instead
MkDocs hooks: takes file paths, not module:func strings, so add a one-line shim, e.g. docs/hooks/makespdf_hook.py:
from makespdf.integrations.mkdocs_plugin import on_post_build_hookand list it under hooks: in mkdocs.yml.
Per-page front-matter
Skip a page, or route it through a saved template instead of the Markdown endpoint:
---
pdf: false # skip this page entirely (no PDF, no bill)
------
pdf-template: invoice-classic # render via POST /api/v1/render instead of /md
customer: Ada # leftover keys + markdown/content/title become template `data`
---A global default template for every page: extra.makespdf.pdf_template (page-level pdf-template wins).
Combined mode
One extra PDF with every markdown-rendered page concatenated:
extra:
makespdf: { pageSize: A4, combined: true } # -> site/combined.pdf
# makespdf: { combined: all-docs.pdf } # custom file namecombined, combined_name, and pdf_template are control keys — consumed by the plugin, never sent as /md options. combined_name alone (without combined) enables combined mode with that file name; explicit combined: false still disables it. Template-routed pages are excluded from the combined PDF (they render through /render, which cannot concatenate as markdown).
Cost and limits
One billed render per page, plus one more when combined mode is on. Markdown text over the 200KB server cap fails per page (the API returns 400, the build fails loudly — split the page). Inline data: images are excluded from that cap; the request body is capped at 15MB. No offline rendering: every call is a hosted API call, so billing matches the web app and CLI.