Recently, I was writing a lot of Asciidoc / Asciidoctor for a document that I was working on for a customer at Red Hat.
⚡Linkified Section Headings in Hugo-Generated Web Pages ⚡ Commenting Code Cheatsheet ⚡ Intertwingling AsciiDoc and Hugo ☯ ⚡ Hugo Tips, Shortcodes, and Fragments ⚡ Hugo’s Markup Languages: AsciiDoc, HTML, Markdown, Org-mode, Pandoc, & reStructuredText. Anyway, my second argument will be less subject to personal interpretation: documents based on text formats are highly interoperable.Not only you can edit them with any text editor on any platform, but you can easily manage text revisions with a tool such as git or SVN, or automate text modification using common tools such as sed, AWK, Perl and so on.
Asciidoc Cheat Sheet
Asciidoctor is a fantastic publishing tool – in fact, I used it to write my book, Camel Step-by-Step – but some of the syntax can be a bit hard to remember, especially when you’re using more advanced features like code snippets or admonitions (those “note”/”warning”/”important” type blocks!)
So I thought I’d make a cheatsheet to help me remember the key features that I use. You might not use all of these, or you might use some others that aren’t here. But I thought I would share the cheatsheet in case you find it useful too!
Asciidoc Cheat Sheet Note
Don't miss my next post!
Asciidoc Include
Join my newsletter to enjoy my latest tutorials, thoughts and recommended links, no more than 2-3 times per month. Put your details in the form below to join today.