MARKDOWN-IT(1)

💖 MARKDOWN-IT(1) 💖

okay bestie, welcome to the markdown-it manual page — user commands edition, she's a whole vibe, she's from the markdown-it-py girlies, dated 2026-05-13, and she is literally just here to turn your Markdown into HTML. no cap.

---

✨ NAME ✨

markdown-it — parse Markdown and write HTML 🦋

---

🌸 SYNOPSIS 🌸

fr fr, here's how you call her:

markdown-it [OPTIONS] [FILE...]

markdown-it --stdin [OPTIONS]

---

💅 DESCRIPTION 💅

markdown-it converts Markdown to HTML using markdown-it-py. it's giving ✨converter✨ and honestly? she ate.

if you hand her one or more FILE arguments, every single file gets read and rendered straight to standard output. like, she's serving each one, okay?

if you set --stdin, she reads the Markdown from standard input and renders it to standard output. piped girlie behavior, we love her 🫶

but if there are no files AND no --stdin? she switches into interactive mode — that's REPL-style input, bestie, she'll start talking back to you 😭

---

👑 OPTIONS 👑

• --stdin — read Markdown from standard input. the humble icon. the main character of safe scripting 🌈
• -v, --version — show version information and exit. quick lil flex, then she's out 💅
• -h, --help — show help text and exit. exactly what it says on the tin 🎀

---

🚨 SAFE USAGE 🚨

bestie. listen. this one matters.

to use markdown-it as a non-interactive filter, always pass --stdin. periodt.

do not rely on implicit stdin redirection like this:

markdown-it < input.md

why?? because that form enters interactive mode, writes prompts to standard output 😭, and can produce unexpected HTML output. like the HTML equivalent of a jumpscare 💀

use this instead:

markdown-it --stdin < input.md > output.html

see how much better that feels? immaculate. no notes ✨

---

🧚 EXAMPLES 🧚

render a file, classic behavior:

markdown-it README.md > README.html

render multiple files (concatenated output, she's stacking them like a fit 👑):

markdown-it header.md body.md footer.md > page.html

render piped input, the safe way:

cat README.md | markdown-it --stdin > README.html

---

🍓 SEE ALSO 🍓

ngl, this page didn't list any SEE ALSO references, but you can always run markdown-it --help if you need her to introduce herself again 🫶

---

okay that's the whole page, you're officially educated, i'm so proud of you 💜

signing off: this one came from markdown-it-py, version dated 2026-05-13, and she's a user-commands kind of girl — and the manual name is literally right there in the title, MARKDOWN-IT(1). slay. bye bestie! 🌸✨