cmark-gfm(1)

💖 cmark-gfm — the group-chat guide 💖

okay so bestie, you found the cmark-gfm page in the General Commands Manual and I'm literally so glad you're here 🫶 this is the tool that takes your Markdown and turns it into fancy output, and honestly? it's giving main character energy. let's get into it.

---

✨ NAME ✨

cmark — converts CommonMark formatted text (with those GitHub Flavored Markdown extensions, iykyk) into HTML 💅

---

🌸 SYNOPSIS 🌸

cmark-gfm [options] file*

---

🦋 DESCRIPTION 🦋

cmark-gfm takes Markdown formatted plain text and converts it to HTML, groff man, CommonMark XML, LaTeX, or CommonMark, following the conventions laid out in the CommonMark spec ✨

It reads input from stdin or from the files you name — and bestie, it concatenates their contents, so yes, multiple files are a vibe 🎀 — and it writes the output to stdout.

---

💅 OPTIONS 💅

okay this is the part you actually came for, no cap 👑

• --to, -t FORMAT — tell it what you want out the other side: html, man, xml, latex, or commonmark. pick your fighter ⭐
• --width WIDTH — set a column width for wrapping the output 🧚 and for no wrapping at all, use the value 0 (that's the default, she's lowkey chill by nature). heads up though: this option currently only affects the commonmark, latex, and man renderers 💜
• --hardbreaks — renders soft breaks (those sneaky newlines inside paragraphs in your CommonMark source) as hard line breaks in the target format 🔥 but if you use this, hard wrapping is disabled for CommonMark output, regardless of whatever value you gave --width. she said pick a lane 💀
• --nobreaks — the opposite vibe: renders soft breaks as spaces ✨ and if you specify this one, hard wrapping is disabled for all output formats, regardless of the value given with --width. periodt 🌈
• --sourcepos — include the source position attribute 🎯
• --normalize — consolidate adjacent text nodes 🧹 (decluttering, we love to see it)
• --extension, -e EXTENSION_NAME — specify an extension name to use 🦋
• --list-extensions — list all the available extensions and then quit 👋 (like a little menu, bestie)
• --validate-utf8 — validate UTF-8, replacing illegal sequences with U+FFFD 🙈
• --smart — use smart punctuation 💖 straight double and single quotes get rendered as curly quotes, depending on their position. -- becomes an en-dash, --- becomes an em-dash, and ... becomes ellipses. tiny typography glow-up, obsessed 🎀
• --unsafe — render raw HTML and potentially dangerous URLs 💀 (so: raw HTML is not replaced by a placeholder comment, and potentially dangerous URLs are not replaced by empty strings). dangerous URLs are those that begin with javascript:, vbscript:, file:, or data: (except for image/png, image/gif, image/jpeg, or image/webp mime types). like, she's literally called "unsafe", be mindful bestie 😭
• --help — print usage information 🫶
• --version — print version 👑

---

👑 AUTHORS 👑

John MacFarlane, Vicent Marti, Kārlis Gaņģis, Nick Wellnhofer. icons, all of them 💜

---

🌈 SEE ALSO 🌈

CommonMark spec: http://spec.commonmark.org — go read it, it's giving homework but the fun kind 📚✨

---

quick vibe check before you go: --unsafe really does mean unsafe, and --hardbreaks / --nobreaks will override your --width wrapping. don't say I didn't warn you 💅

---

and that's the whole page, bestie 🍓 this one came from the LOCAL source, version-dated March 24, 2016 — yeah she's an older icon but she still ate 💖 mwah, go convert some markdown 🧚‍♀️✨