panache-parse(1)

✨ NAME ✨

panache-parse — parse and display the CST tree for debugging. Hi bestie, this is the panache-parse(1) page from the General Commands Manual, and we're about to make CSTs make sense 💅.

🛠️ SYNOPSIS 🛠️

panache parse [--to] [--json] [-h|--help] [-V|--version] [FILE]

💅 DESCRIPTION 💅

Okay so you parse a document and it displays its Concrete Syntax Tree (CST) for debugging and understanding how Panache interprets the document structure. Iconic. The CST shows all block and inline elements detected by the parser — every single one, no cap 👑.

🎀 OPTIONS 🎀

• --to <FORMAT> [default: cst] — choose what to print to stdout:
  • cst (default): debug-format CST tree, useful for parser debugging.
  • pandoc-ast: pandoc-native AST text, the same shape produced by pandoc -f markdown -t native. Unsupported constructs emit visible Unsupported "<KIND>" sentinels rather than being silently dropped.
  • pandoc-json: the same AST encoded as JSON, matching pandoc -f markdown -t json. UTF-8 round-trips cleanly through jq/ascii2uni since strings use standard JSON escaping rather than Haskell-show numeric escapes.

Possible values:

• cst
• pandoc-ast
• pandoc-json

• --json <PATH> — write the parsed CST to the given JSON file in addition to printing the selected --to format to stdout. The JSON output is always CST-shaped regardless of --to; it includes node kinds, text ranges, and token text. Slay, but keep that distinction 💖.
• -h, --help — Print help (see a summary with '-h').
• -V, --version — Print version.
• [FILE] — path to the input file to parse. If it's not provided, or if - is given, it reads from stdin. Important vibe check: with no arguments at an interactive terminal this is a usage error instead, since there is nothing to read. The parser respects extension flags from the configuration file.

🌸 VERSION 🌸

v3.16.0 — that's the version, bestie, short and sweet 🎀.

🦋 SEE ALSO 🦋

panache(1), panache-format(1), panache-lsp(1), panache-lint(1), panache-clean(1), panache-debug(1) — go read the whole squad, iykyk 💜.

---

Cute sign-off time 🫶: the footer source/version says parse 3.16.0, the page title is panache-parse(1), and the VERSION section says v3.16.0. The original footer shows no date, so there's no date to mention — no invented dates here, periodt ✨.