Introduction to Mallard

Further resources

The Project Mallard website - 

The Project Mallard website contains tutorials, schemas, specifications, early drafts of the language, and candidates for adoption as well as information about the project's history and contributors. 

The Mallard mailing list - 

Join the Mallard mailing list to get help with authoring documentation in Mallard or to become a contributor to the project. See also the mailing list archives at 

Mallard Cheat Sheet - 

The Mallard Cheat Sheet lists the key elements of Mallard. It shows you how to create pages, sections, links, and automatic links; how to create paragraphs, lists, and tables; how to include multimedia, code, GUI paths, and key combinations; how to specify languages, language directionality, and translator notes; and how to include meta-information such as page credits, page blurbs, and page revision notes. Plus more: all in one handy page.


GNOME is a desktop environment and graphical user interface that runs on top of UNIX-based operating systems such as Linux. GNOME is part of the GNU project and is free open source software; Mallard is the preferred system of help documentation for GNOME and for several GNOME applications. 

The Gist - 

The Gist: Thoughts on Open Source, Tech Comm, and XML is the blog of primary Mallard developer Shaun McCance. There are several useful posts, including the following: help system specification -

Yelp, the principal Mallard viewer, uses the help system specification as the basis for its link URI scheme. The specification describes a link URi scheme for help (Mallard and HTML pages), info and man pages, as well as an override mechanism using the environment variable XDG_DATA_DIRS.

itstool -

Translate your Mallard documentation using PO files with itstool. The build system integration of yelp-tools uses itstool to extract translatable strings from Mallard documentation. Use ITS features for finer control over translation of Mallard content.