Introduction
Build elegant and highly usable documentation websites using Mordoc.
Mordoc is a documentation site generator that transforms your content into clean, elegant, and highly usable documentation websites.
You write Markdown content and simple configuration files, and Mordoc takes care of the rest by handling navigation, layouts, styling, and structure. The result is a fully functional documentation site that feels professional out of the box.
Why Mordoc?
There are plenty of great documentation tools out there, and many of them already do an excellent job. So… why another one?
Many documentation tools offer rich content writing experiences, but they often come bundled with hosted platforms, proprietary editors, or rigid workflows. Others provide powerful foundations, but expect teams to assemble everything themselves. Every organization is different, and these approaches do not always fit.
Mordoc takes a different approach. It provides an open source documentation generator that allows teams to maintain content as code and deploy it to any infrastructure they choose. With the documentation app and components built in, content writers can start writing immediately using simple, easy-to-learn syntax.
You do what you do best, writing content, and let Mordoc take care of the rest.
Here’s what that looks like in practice.
Content as code
Mordoc treats content as code without forcing authors to think like developers. Your content lives in files, so changes are tracked and reviewable, version history is explicit, and collaboration scales naturally with your team, just as it would for a codebase. You get the benefits of modern change management while keeping the writing experience lightweight and focused.
Content‑first, component‑driven
Mordoc leverages Markdown, the most popular syntax for writing content, and provides additional built-in custom documentation components you need (cards, callouts, code blocks, tables, and more) by harnessing Markdoc. There is nothing to assemble before you start writing, and once installed, those components can be reused everywhere through clear, readable syntax.
That leaves content writers free to focus on structure and clarity instead of implementation details, and it keeps documentation consistent across pages and contributors, even as more people write. The syntax itself is intentionally limited and predictable, designed to be easy to learn, easy to read, and easy to maintain over time.
No vendor lock‑in
Your documentation belongs to you. Host it anywhere, deploy it on any infrastructure, and move away whenever you like without rewriting a word of content. Mordoc generates documentation websites; it doesn’t trap your content inside a platform.
Built for collaboration
Mordoc is designed so that content creators can focus on writing and structure, while developers step in for setup and infrastructure only when needed. That separation of concerns makes documentation easier to scale and easier to maintain.
Open source by design
Mordoc is open source and transparent: no black boxes, no hidden behavior, just community‑driven improvements. You can inspect it, understand how it works, and adapt your documentation workflow to your needs.
Curious to see how it works? Let’s get started.
Next step
- Install a code editor. It’s a helpful tool, and you won’t be doing any coding.