Is the tikz.dev HTML Manual the Official PGF/TikZ Documentation?

Updated

No — tikz.dev is an unofficial HTML rendering of the official PGF/TikZ manual. The content originates from the official documentation (edited by Till Tantau, with contributions from other authors), but the HTML version itself is maintained by Dominik Peters and generated with the lwarp package. For most reading and reference purposes it is a faithful, convenient copy; for authoritative citation or version-critical work, verify against the official source.

What the page itself states

The manual's opening page is explicit about its status:

  • Title: "TikZ and PGF Manual"
  • Version line: "Updated 2026-10-09 – Manual for Version 3.1.12"
  • Status label: "Unofficial HTML Version"
  • Maintainer: Dominik Peters, produced using the lwarp package
  • Documentation editor: Till Tantau; parts written by other authors as indicated in those chapters and in Section 1.5

So the text is the official manual; the HTML edition is a third-party conversion. That distinction matters if you are quoting version numbers, reporting documentation errors, or need the canonical PDF.

What tikz.dev offers

The site presents the full manual in browsable HTML form, including:

  • Tutorials paced for beginners: "A Picture for Karl's Students," "A Petri-Net for Hagen," "Euclid's Elements," and "Diagrams as Simple Graphs"
  • Core reference chapters: specifying coordinates, path specifications, actions on paths, arrows, nodes and edges, pics, graphs, matrices and alignment, trees, function plots, transparency, decorations, transformations, and animations
  • Libraries: 3D drawing, angles, automata, calendar, circuits, decorations, fitting, matrix, mindmap, paper-folding, patterns, three-point perspective, Petri nets, shadings, shadows, shapes, and spy
  • Graph drawing and data visualization sections, including layouts (trees, layered, force-based, circular, phylogenetic) and axes/visualizers
  • Quick links to frequently used commands such as \node, \fill, \draw, \foreach, color, circle, arc, grid, rectangle, label, edge, anchor, and clip

The manual describes TikZ as a set of TeX commands that draw graphics directly with pdfLaTeX, now grown into a full graphics language with a manual of over a thousand pages. The introduction notes that the breadth of options can be daunting to beginners, which is why the slow-paced tutorials exist.

When to use it, and when to check elsewhere

Situation Use tikz.dev? Why
Learning TikZ from scratch Yes Tutorials are reproduced in full and easy to navigate in a browser
Looking up a command or library option Yes Quick links and chapter structure make lookup fast
Checking behavior for a specific version With care Confirm the version banner (3.1.12, updated 2026-10-09) matches your TeX installation
Citing the manual formally Prefer official The page is self-labeled unofficial; cite the official PGF/TikZ documentation
Reporting a documentation error Prefer official channels The HTML conversion is maintained separately from the documentation itself

Practical checks before relying on a page

  1. Read the version banner first. If your local TeX distribution ships a different PGF version, an option documented here may not exist yet — or may behave differently.
  2. Cross-check syntax against a minimal example. The manual's own examples are the fastest verification: compile a short snippet such as \tikz \draw (0pt,0pt) -- (20pt,6pt); and confirm the output matches the description.
  3. Note the HTML conversion caveat. Because the site is generated with lwarp, occasional rendering artifacts in code samples or cross-references are possible; if something looks broken, compare with the PDF manual for the same version.

In short: treat tikz.dev as a reliable, well-organized reading copy of the official manual — just don't describe it as the official publication itself.