Follow

Is there a documentation generator that lets you basically write Markdown, and will create a nice web site from that? Needs support for anchors, per-page table of contents, “information” and “warning” boxes and source code highlighting.

Seems like Gitbook USED to be like that?

@deshipu @uliwitness MkDocs with the mkdocs-material is absolutely perfect for all my documentation needs, and there's a cracking amount of plugins. You can add arbitrary JS/CSS overrides too. For example I added Klipse to one documentation site for inline code samples, and the python markdownx libraries with custom code fences + custom JS can let you generate Mermaid diagrams on demand 🙃 (it's all python, so it's easy to dockerise, but perhaps a bit daunting if new to python)

Sign in to participate in the conversation
Mastodon for Tech Folks

The social network of the future: No ads, no corporate surveillance, ethical design, and decentralization! Own your data with Mastodon!