OMD(1)

💖 NAME 💖

okay so bestie, listen — omd is a Markdown frontend in pure OCaml. that's it, that's the whole vibe. (it's from the OMD(1) manual, User Commands section, iykyk 🫶)

---

🌸 DESCRIPTION 🌸

here's how you call her:

omd [options] [inputfile1 .. inputfileN] [options]

yep, options can go literally anywhere, before and after your input files. she's flexible like that. 💅

and now the flag menu, bestie — read it, don't skim it, there WILL be a quiz (there will not be a quiz):

• -o file.html — tells her where to put the output. default is stdout, so if you don't say anything she just yells into the terminal. iconic honestly.
• -- — everything after this is treated as input file names, no cap. all remaining arguments, consider them files.
• -u — use standard Markdown style for emph/bold when you're using _. slay.
• -c — ignore any line that starts with !!! (that's 3 or more exclamation points, she counted).
• -C — ignore everything on a line after !!! (again, 3 or more exclamation points).
• -m — output Markdown instead of HTML. yes she can spit Markdown back out. versatile queen.
• -notags — output without the HTML tags.
• -toc — replaces *Table of contents* with the actual table of contents. the way that works?? obsessed.
• -otoc — output only the table of contents. nothing else. just the toc. main character energy.
• -ts f — section for the Table of contents. default is all.
• -td f — Table of contents depth. default is 2.
• -H — protect HTML comments. keep them safe. 🛡️
• -r l=p — register program p as a code highlighter for language l.
• -R l — registers unknown languages to be l instead of void.
• -nl2br — convert new lines to <br/>.
• -x ext — activate extension ext (not yet implemented, so like... manifest it bestie ✨).
• -l — list available extensions ext (also not yet implemented 🙈).
• -b — don't check validity of HTML tag names. live dangerously.
• -s — (might not work as expected yet 🫠) Block HTML only in block HTML, inline HTML only in inline HTML (semantics undefined if use both -b and -s).
• -LHTML — List all known HTML tags
• -LHTMLi — List all known inline HTML tags
• -version — Print version.
• -VS start — Set the start token to use to declare a verbatim section. If you use -VE, you must use -VS, and both must be non-empty.
• -VE end — Set the end token to use to declare a verbatim section. If you use -VE, you must use -VS, and both must be non-empty.
• -w — Activate warnings (beta).
• -W — Convert warnings to errors, implies -w (beta).
• -help — Display this list of options
• --help — Display this list of options

🚨 heads up bestie: -x and -l are not yet implemented, -s might not work as expected yet, and -w / -W are beta. also if you run -b and -s together, the semantics are undefined. that's not me being dramatic, that's the manual. don't do it. fr fr. 💀

---

🦋 SEE ALSO 🦋

the full documentation for omd lives in a Texinfo manual. if info and omd are properly installed at your site, then this command:

info omd

should hand you the complete manual. go get it, you deserve the whole thing. 💜

---

and that's a wrap on the omd page, bestie 🎀 this was version omd 1.3.2, dated June 2025, filed under OMD(1). go write some Markdown, you absolute icon 👑✨