TIKZTOSVG(1)

📦 version 2026.0, in alpine 3.24

💖 TIKZTOSVG(1) 💖

✨ NAME ✨

tikztosvg, bestie, is the tool that turns your TikZ diagrams into SVG. Literally that's the whole job 🦋

🎀 SYNOPSIS 🎀

tikztosvg [OPTION]... INPUT_PATH

📝 DESCRIPTION 📝

okay so the tikztosvg(1) command renders your TikZ diagrams into SVG and it is so good at it 💅

If INPUT_PATH is -, it reads your input from stdin. no file needed, we're giving main character energy 🌸

🌷 OPTIONS 🌷

  • -o, --output=OUTPUT_PATH — this is where your SVG lands 🧚 Write to OUTPUT_PATH. If you set it to -, it prints to stdout instead. If you don't pick one, it uses the base name of your input file with .svg slapped on the end. The path is resolved relative to the working directory, so keep that in mind 📂
  • -p, --package=+PACKAGE — want an extra package? Add it here and it gets \usepackage{PACKAGE} when the diagram renders 📦 Just so you know, tikz, tikz-cd, pgfplots, amsmath and amssymb are always included by default, so you don't need to ask for them 💜
  • -l, --library=+_LIBRARY — same energy as above, but for TikZ libraries. It adds \usetikzlibrary{LIBRARY} to your render 🎨
  • -q, --quiet — shh 🙈 This silences the application log messages and script warnings, so it's nice and calm
  • --lualatex — uses LuaTeX as your TeX engine. Fair warning, LuaTeX is already the default, so this flag doesn't really do much 🌈
  • --xelatex — switches to XeTeX as your TeX engine ✨
  • --pdflatex — switches to pdfTeX as your TeX engine 🍓
  • -h, --help — prints a help message when you need a little reminder 🫶
  • -v, --version — prints the version info 🔥

🧚 ENVIRONMENT 🧚

okay this is important bestie: tikztosvg needs XeTeX and pdf2svg installed before it can do anything. Also make sure any extra LaTeX packages are installed before you use them in a diagram, or it's gonna be a whole mess 😭

🚦 EXIT STATUS 🚦

  • 0 — success, we did it 🎉
  • 1 — failure. This one covers syntax or usage errors and configuration errors 💀
  • [n] — failure during document processing 🙈

👑 AUTHORS 👑

tikztosvg was written by Pablo, pablo-escobar@riseup.net 🫶

pdf2svg was written by David Barton, davebarton@cityinthesky.co.uk, and Matthew Flaschen, matthew.flaschen@gatech.edu 💜

🌈 RESOURCES 🌈

💅 COPYING 💅

Copyright (C) 2021 Pablo. Free use of this software is granted under the terms of the GPL-3.0 License. Share it, use it, be iconic with it ✨

bestie, that's the whole page 💖 This was the TIKZTOSVG(1) manual, last updated 2021-08-19. Go make some gorgeous diagrams 🧚💅🌈

📦 where this page comes from