md2po(1)

💅 md2po — the one where your Markdown becomes a PO file

okay so first things first: this is md2po, and she lives in the Translate Toolkit family (specifically Translate Toolkit 3.19.5, in case you were wondering which era of slay we're in ✨). Her whole thing? She takes your Markdown files and turns them into Gettext PO localization files. Like a glow-up but for translation units. 👑

---

🌸 SYNOPSIS 🌸

no thoughts, just vibes, but the vibes are extremely specific:

md2po [--version] [-h|--help] [--manpage] [--progress PROGRESS]
[--errorlevel ERRORLEVEL] [-i|--input] INPUT [-x|--exclude EXCLUDE]
[-o|--output] OUTPUT [-t|--template TEMPLATE] [-S|--timestamp]
[-P|--pot] [--duplicates DUPLICATESTYLE] [--multifile MULTIFILESTYLE]
[--no-code-blocks] [--no-frontmatter] [--no-placeholders]

periodt. 💅

---

🦋 DESCRIPTION 🦋

bestie, the docs said it better than I ever could, so here's where you go for examples and usage instructions:

http://docs.translatehouse.org/projects/translate-toolkit/en/latest/commands/md2po.html

that's it, that's the description. go read it, I'll wait 🫶

---

✨ OPTIONS ✨

every single flag, no skips, no shortcuts, because we don't gatekeep here 💖

• --version — shows the program's version number and then dips 👋
• -h/--help — shows you this very help message and then dips 👋
• --manpage — outputs a manpage based on the help. very meta of her, honestly 🙈
• --progress — shows progress as: dots, none, bar, names, verbose. pick your fave, they're all valid 💅
• --errorlevel — shows errorlevel as: none, message, exception, traceback
• -i/--input — reads from INPUT in markdown, md, text, txt formats 📥
• -x/--exclude — excludes names matching EXCLUDE from input paths. not today, unwanted files 🚫
• -o/--output — writes to OUTPUT in po, pot formats 📤
• -t/--template — reads from TEMPLATE in 🌱
• -S/--timestamp — skips the conversion if the output file has a newer timestamp. she checks the receipts first, iconic behavior ⏰
• -P/--pot — outputs PO Templates (.pot) rather than PO files (.po)
• --duplicates — what to do with duplicate strings (identical source text): merge, msgctxt (default: 'msgctxt')
• --multifile — how to split po/pot files (single, toplevel or onefile)
• --no-code-blocks — do not extract code blocks for translation 🧱
• --no-frontmatter — do not extract front matter for translation
• --no-placeholders — render inline elements (links, images, autolinks, HTML spans) verbatim in translation units instead of replacing them with {n} placeholder markers. lowkey a big deal if you care about your brackets 🎀

---

and that's the whole page, bestie! this absolute queen was brought to you by Translate Toolkit 3.19.5, and yes her name is still md2po(1). go translate something gorgeous 💖✨🌷