MARKDOWN_PY(1)
β¨ MARKDOWN_PY(1) β¨
okay bestie, gather round, because we're talking about markdown_py β it's a Python implementation of John Gruber's Markdown, and it's literally the moment. π
π SYNOPSIS π
markdown_py [options] [INPUT_FILE]
(STDIN is assumed if no INPUT_FILE is given)
so like. you give it options, maybe a file, and if you don't give it a file it just reads from STDIN like the chill little icon it is. periodt. π
πΈ DESCRIPTION πΈ
Command-line Markdown compiler based on python-markdown module, with extensions support. she compiles markdown from the command line and she supports extensions, okay?? main character behavior.
Deprecated! Usepython3 -m markdowninstead, which accepts the same options. like, no cap, that's the move now. this one still works and takes all the same flags, but the glow-up version ispython3 -m markdown. π
π OPTIONS π
here's the full roster, no skips, no cuts, every single one:
--versionβ Show program's version number and exit. cute lil "who am I" moment. π¦-h,--helpβ Show the help message and exit. when you're lost, she's got you. π«Ά-f OUTPUT_FILE,--file=OUTPUT_FILEβ Write output to OUTPUT_FILE. Defaults to STDOUT. so if you don't tell her where to put it, it's going straight to your screen, bestie. β¨-e ENCODING,--encoding=ENCODINGβ Encoding for input and output files. tell her what language the bytes are speaking. π-o OUTPUT_FORMAT,--output_format=OUTPUT_FORMATβ Use output format 'xhtml' (default) or 'html'. two flavors, pick your vibe. π-n,--no_lazy_olβ Observe number of first item of ordered lists. she'll actually respect where your ordered list starts. so real of her. π₯-x EXTENSION,--extension=EXTENSIONβ Load extension EXTENSION. stack 'em up, more extensions more fun. π-c CONFIG_FILE,--extension_configs=CONFIG_FILEβ Read extension configurations from CONFIG_FILE. CONFIG_FILE must be of JSON or YAML format. YAML format requires python3-yaml package to be installed. 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. The extensions must also be loaded with the--extensionoption. so like β this one is doing a LOT, she's the overachiever of the group. and heads up: if you go the YAML route you need thepython3-yamlpackage installed, no exceptions. also the config alone isn't enough, you still gotta load the extensions with--extension. iykyk. π-q,--quietβ Suppress all warnings. shhh. nothing to see here. π-v,--verboseβ Print all warnings. okay NOW we're yapping, tell me everything. π--noisyβ Print debug messages. she's not just talking, she's oversharing. π
and that's the whole page, bestie. this one comes from the General Commands Manual, filed under markdown_py(1) β same section number, same name, she's iconic and she knows it. mwah. πβ¨π
π¦ where this page comes from
- debian bookworm: python3-markdown 3.4.1-2+deb12u1 Β· BSD-3-Clause
- debian trixie: python3-markdown 3.7-2+deb13u1 Β· BSD-3-Clause
- ubuntu jammy: python3-markdown 3.3.6-1 Β· BSD-3-Clause
- ubuntu noble: python3-markdown 3.5.2-1 Β· BSD-3-Clause
- ubuntu questing: python3-markdown 3.8.2-2
- ubuntu resolute: python3-markdown 3.10.2-1 Β· BSD-3-Clause
- ubuntu stonking: python3-markdown 3.10.3-1 Β· BSD-3-Clause
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms