Structured Authoring
DocBook, Structured Authoring & XML Publishing Standard
Overview
What is DocBook?
DocBook is a semantic markup language for technical documentation, capturing content by its logical structure rather than its presentation so one source produces many outputs. It began in 1991 at HaL Computer Systems and O'Reilly, and moved to OASIS in 1998. The current version, DocBook 5.2, became an OASIS Standard in February 2024, with RELAX NG as its normative schema; the OASIS technical committee then closed in September 2024, and the vocabulary continues to be maintained outside OASIS.
Where to get the document
Key Features
- Semantic markup: focus on meaning, not presentation
- Rich element set: comprehensive vocabulary for technical docs
- Multiple output formats: HTML, PDF, EPUB from one source
- Cross-references and linking: sophisticated reference capabilities
- Internationalization: support for multiple languages
Also written as: OASIS DocBook
Who DocBook Applies To
DocBook is an open standard (DocBook 5.2, an OASIS Standard since February 2024) with no industry mandate behind it. It suits organizations whose deliverables are genuinely book-shaped (manuals, references, guides), and which want a rich vocabulary immediately rather than an architecture to build on. Choosing it is a judgment about the shape of your content, not about compliance.
Where DocBook Programs Go Wrong
- Choosing DocBook when the real requirement is reuse across many publications, which is the problem DITA was designed for.
- Using its breadth without constraint. The element set is large, and an unconstrained subset makes content inconsistent between authors and harder to transform.
- Leaving legacy SGML DocBook unconverted until a toolchain change forces it.
How It Relates to Other Standards
DocBook Questions
What is the current version of DocBook?
DocBook 5.2, approved as an OASIS Standard on 6 February 2024. Its normative schema is RELAX NG with Schematron assertions; W3C XML Schema and DTD versions are also provided. Version 5.1 (2016) added topics and assemblies for topic-based authoring.
What is DocBook?
A semantic markup vocabulary for technical documentation. Content is captured by what it means rather than how it should look, so one source produces HTML, PDF and other outputs. Its element set is comprehensive out of the box, which is its main practical advantage over architectures you have to model first.
Is DocBook still worth using?
For book-shaped technical content with an established toolchain, yes. It is stable rather than stagnant: DocBook 5.2 was approved in 2024, and the modern xslTNG stylesheets are actively released. The decision is rarely DocBook versus nothing. It is DocBook versus DITA, and it turns on whether your content is documents that need structure or topics that need assembling.
Where to Get DocBook
Free: the DocBook 5.2 schemas, the definitive guide (tdg.docbook.org), and the stylesheets are all openly available. The OASIS technical committee closed in September 2024; docbook.org remains the home of the vocabulary.
Where DocBook Applies
All standardsTechnical publications servicesTalk to us about DocBook
Get In Touch
Let's Talk
Planning, building, or migrating DocBook-compliant technical content? We can help.