MARKDOWN-CALIBRE(1)

💖 MARKDOWN-CALIBRE(1) 💖

okay bestie, welcome to the markdown-calibre era — it's a User Commands page, and it is literally the moment markdown becomes ✨markup✨.

🌸 NAME 🌸

markdown-calibre — convert Markdown text to XHTML/HTML

like. that's it. that's the whole job. and she ATE. 💅

🎀 SYNOPSIS 🎀

markdown-calibre [options] [INPUTFILE]

(if you don't hand her an INPUTFILE, she just assumes STDIN. no questions asked, she's chill like that 🫶)

🦋 DESCRIPTION 🦋

It's a Python implementation of John Gruber's Markdown. not a vibe, a lifestyle.

https://python-markdown.github.io/

that's the link, go be nosy, she's iconic.

✨ OPTIONS ✨

okay so here's the menu, no skips, we're reading every single one fr fr:

• --version — shows the program's version number and then dips. bye! 👋
• -h, --help — shows this help message and exits. the "help me bestie" button.
• -f OUTPUT_FILE, --file=OUTPUT_FILE — write the output to OUTPUT_FILE. if you don't say anything, it defaults to STDOUT. she's not shy, she'll just say it out loud. 🗣️
• -e ENCODING, --encoding=ENCODING — the encoding for input and output files. both. matching. couple goals. 💞
• -o OUTPUT_FORMAT, --output_format=OUTPUT_FORMAT — pick your output format: 'xhtml' (the default, the main character 👑) or 'html'.
• -n, --no_lazy_ol — observe the number of the first item of ordered lists. yes she's counting. she's watching. 👀
• -x EXTENSION, --extension=EXTENSION — load extension EXTENSION. plug it in, let it cook. 🔌
• -c CONFIG_FILE, --extension_configs=CONFIG_FILE — read extension configs from CONFIG_FILE. now listen, CONFIG_FILE has to be JSON or YAML format. YAML format requires that a python YAML library be installed, so if it's not, that's a whole thing. 😭 the parsed JSON or YAML must result in a python dictionary which would be accepted by the 'extension_configs' keyword on the markdown.Markdown class. and — this part matters — the extensions must also be loaded with the --extension option. like, both. you need both. don't come back mad at me.
• -q, --quiet — suppress all warnings. shhh. 🤫
• -v, --verbose — print all warnings. tell me EVERYTHING. 🗣️🔥
• --noisy — print debug messages. louder. LOUDER. she's giving main character energy and honestly? respect. 📢

🌈 SEE ALSO 🌈

• calibre(1) — her big sister, go say hi 💜

that's the whole page bestie, you're so ready. no cap, you understood all of it. periodt. 🧚

— with love from markdown-calibre, August 2021 💖✨🎀🦋🌸💅🫶