SDML(1)

✨ NAME ✨

sdml convert — bestie, this one converts a module into an alternate representation 💅

---

🦋 SYNOPSIS 🦋

sdml convert [OPTIONS] --output-format <OUTPUT_FORMAT> [MODULE]

---

💖 DESCRIPTION 💖

Okay so, converting a module into an alternate representation. That's the whole mission, that's the vibe 🌈

This command lets you take a module from the SDML surface syntax and turn it into any one of a bunch of other representations. Choose your fighter:

• RDF</> :: this uses the surface-to-RDF mapping defined in the SDML Language Reference. And no cap, that mapping is normative and stable — it's the trustworthy one, the main character 👑
• JSON</> :: this is a direct representation of the in-memory model in the Rust package sdml_core, rendered as JSON. Heads up though: this mapping is non-normative and may change according to any model structure change. It's giving "fashion, but it evolves" 🦋
• S-Expression</> :: this one is a debugging representation. It's supported because the underlying tree-sitter library uses s-expressions as a parse-tree visualization. It's the backstage-pass format 🎀

🫶 Arguments:

• [MODULE] — an SDML module, loaded using the standard resolver. Drop it in and let the resolver do its thing ✨

---

🌸 OPTIONS 🌸

• -f, --output-format <OUTPUT_FORMAT> — the format you want out the other side. Possible values are:
  • json — JSON
  • json-pretty — Pretty-printed JSON
  • rdf — RDF Abstract Model
  • s-expr — S-Expressions
• -o, --output <OUTPUT> — file name to write to, or - to write to stdout. Default is -, so by default she's streaming straight to your terminal, periodt 💅
• -i, --input <INPUT> — input SDML file name to read from, or - to read from stdin. Default is - 🍓
• -h, --help — print help (see a summary with '-h') 🙈
• -V, --version — print version 👑

---

fr fr, just remember: --output-format is not optional, bestie. If you skip it, she's not going anywhere 😭

---

That's the whole page, you ate it 🎀 this was sdml convert version 0.3.2+20250310, written down back in October 2025 — and it lives as SDML(1) in the manual, iconic as ever 👑💜