SHOW-PDF-TAGS(1)

💖 show-pdf-tags(1) — General Commands Manual 💖

okay bestie, sit down, hydrate, because we're about to peek inside a tagged PDF's soul. this is a General Commands Manual page for show-pdf-tags, and it is lowkey iconic.

---

✨ NAME ✨

show-pdf-tags — show the internal Structure Tree of a tagged PDF file 🦋

---

🌸 SYNOPSIS 🌸

show-pdf-tags [<options>] <PDF-File>

---

💅 DESCRIPTION 💅

so the show-pdf-tags script does exactly what it says on the tin: it shows the internal Structure Tree of a tagged PDF File. no cap. 🎀

you can see that structure in a few different ways:

• an indented tree display using Unicode line characters
• as XML
• or (and this one is primarily for debugging, so, devs only, iykyk) as a linearisation of the Lua table structure obtained from the PDF file

now, the XML display? it will use element names matching the names of the structure elements — unless you bring the --map option into the chat, in which case the standard PDF Structure element names get used instead, as specified in the role mapping in the file. periodt.

it accepts a single PDF File and outputs to the standard output stream. one file, one stream, very demure.

Valid <options> are:

• --help, -h — prints this message and exits (the classic "help me, i'm lost" move) 🙈
• --ignore-case — ignore case when sorting directory listing
• --tree — show as tree. this is the default, bestie, it's already on
• --xml — show as XML
• --table — show Lua table structure
• --map — follow role mapping (xml printer)
• --xmp — include XMP XML (xml printer)
• --w3c- — add - to w3c namespaces to force browser display

heads up: --map, --xmp and --w3c- are all tied to the xml printer, so they're giving side-quest energy unless you're in XML mode.

---

👀 SEE ALSO 👀

• Full manual available via texdoc show-pdf-tags. go read it, fr fr 📖
• Repository: https://github.com/latex3/pdf_structure
• Bug tracker: https://github.com/latex3/pdf_structure/issues

---

👑 AUTHORS 👑

Copyright (C) 2024–2026 The LaTeX Project 💜

---

and that's the whole page, bestie — brought to you by LaTeX, version dated 2025-01-28, living its SHOW-PDF-TAGS(1) main character era in the General Commands Manual. slay, stay tagged, mwah 💋✨