diff options
Diffstat (limited to 'asciidoc.html.markdown')
-rw-r--r-- | asciidoc.html.markdown | 122 |
1 files changed, 122 insertions, 0 deletions
diff --git a/asciidoc.html.markdown b/asciidoc.html.markdown new file mode 100644 index 00000000..8326c581 --- /dev/null +++ b/asciidoc.html.markdown @@ -0,0 +1,122 @@ +--- +language: asciidoc +contributors: + - ["Ryan Mavilia", "http://unoriginality.rocks/"] +filename: asciidoc.md +--- + +AsciiDoc is a markup language similar to Markdown and it can be used for anything from books to blogs. Created in 2002 by Stuart Rackham the language is simple but it allows for a great amount of customization. + +Document Header + +Headers are optional and can't contain blank lines. It must be offset from content by at least one blank line. + +Title Only + +``` += Document Title + +First sentence of document. +``` + +Title and Author + +``` += Document Title +First Last <first.last@learnxinyminutes.com> + +Start of this document. +``` + +Multiple Authors + +``` += Document Title +John Doe <john@go.com>; Jane Doe<jane@yo.com>; Black Beard <beardy@pirate.com> + +Start of a doc with multiple authors. +``` + +Revision Line (requires an author line) + +``` += Doc Title V1 +Potato Man <chip@crunchy.com> +v1.0, 2016-01-13 + +This article about chips is going to be fun. +``` + +Paragraphs + +``` +You don't need anything special for paragraphs. + +Add a blank line between paragraphs to separate them. + +To create a line blank add a + +and you will receive a line break! +``` + +Formatting Text + +``` +_underscore creates italics_ +*asterisks for bold* +*_combine for extra fun_* +`use ticks to signify monospace` +`*bolded monospace*` +``` + +Section Titles + +``` += Level 0 (may only be used in document's header) + +== Level 1 <h2> + +=== Level 2 <h3> + +==== Level 3 <h4> + +===== Level 4 <h5> + +====== Level 5 <h6> + +======= Level 6 <h7> + +``` + +Lists + +To create a bulleted list use asterisks. + +``` +* foo +* bar +* baz +``` + +To create a numbered list use periods. + +``` +. item 1 +. item 2 +. item 3 +``` + +You can nest lists by adding extra asterisks or periods up to five times. + +``` +* foo 1 +** foo 2 +*** foo 3 +**** foo 4 +***** foo 5 + +. foo 1 +.. foo 2 +... foo 3 +.... foo 4 +..... foo 5 +``` |