KRAMDOWN-RFC(1)

πŸ“¦
version 1.7.39 Β· 2 versions
  • 1.7.39 Β· debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.5.24 Β· ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

πŸ’– KRAMDOWN-RFC πŸ’–

okay so bestie, welcome to the kramdown-rfc page β€” it's a General Commands Manual situation and honestly? it ate. let's get into it 🫢


✨ NAME ✨

kramdown-rfc β€” tool to generate XML2RFC XML from Markdown

like. that's the whole gig. markdown in, fancy RFC XML out. iconic behavior honestly πŸ‘‘


🌸 SYNOPSIS 🌸

kramdown-rfc [mydraft.mkd]

that's it. that's the whole vibe check. optionally hand it a file, or don't, we'll get to that πŸ’…


πŸ¦‹ DESCRIPTION πŸ¦‹

so kramdown(1) is a markdown parser by Thomas Leitner, and the way it works is it has a bunch of backends for generating HTML, Latex, and markdown again. multi-talented fr fr.

kramdown-rfc is an additional backend to that ✨ β€” it lets you generate XML2RFC XML markup (also known as RFC 2629, RFC 7449, or RFC 7991 compliant markup, iykyk). it's designed as a source format for documents in the Internet-Drafts (I-Ds) and Request for Comments (RFC) series, and the whole point is that it gets processed by the xml2rfc utility. that's the pipeline bestie, no cap.

now, the important part: if no file is specified, STDIN will be used 🌈. so if you're typing input directly, you can send an EOF by pressing ^D. yes, ^D, that's your little escape hatch, go off πŸŽ€


πŸŽ€ EXAMPLE πŸŽ€

kramdown-rfc mydraft.mkd > mydraft.xml
xml2rfc mydraft.xml

look at that. two lines. first one turns your mydraft.mkd into mydraft.xml, second one feeds it to xml2rfc. chef's kiss, we love a clean workflow πŸ’–


πŸ‘‘ AUTHOR πŸ‘‘

kramdown-rfc is written by Carsten Bormann <cabo@tzi.org> πŸ’œ

This manual page was written by Cédric Boutillier <boutil@debian.org> for the Debian project 🌸


🌈 SEE ALSO 🌈


bestie reminder: the manual name is General Commands Manual, and this whole thing is 2022, April energy. that's the sign-off πŸ’…βœ¨ slay, go write some RFCs 🫢