markdown-syntax.md (3812B)
1 +++ 2 title = "Markdown Syntax Guide" 3 description = "Sample article showcasing basic Markdown syntax and formatting for HTML elements." 4 date = 2020-08-27 5 +++ 6 7 This article offers a sample of basic Markdown syntax that can be used in Zola files. It also shows whether basic HTML elements are decorated with CSS in a Zola theme. 8 <!-- more --> 9 10 ## Headings 11 12 The following HTML `<h1>`—`<h6>` elements represent six levels of section headings. `<h1>` is the highest section level while `<h6>` is the lowest. 13 14 # H1 15 ## H2 16 ### H3 17 #### H4 18 ##### H5 19 ###### H6 20 21 ## Paragraph 22 23 Xerum, quo qui aut unt expliquam qui dolut labo. Aque venitatiusda cum, voluptionse latur sitiae dolessi aut parist aut dollo enim qui voluptate ma dolestendit peritin re plis 24 aut quas inctum laceat est volestemque commosa as cus endigna tectur, offic to cor sequas etum rerum idem sintibus eiur? Quianimin porecus evelectur, cum que nis nust voloribus 25 ratem aut omnimi, sitatur? Quiatem. Nam, omnis sum am facea corem alique molestrunt et eos evelece arcillit ut aut eos eos nus, sin conecerem erum fuga. Ri oditatquam, ad wuibus 26 unda veliamenimin cusam et facea ipsamus es exerum sitate dolores editium rerore eost, temped molorro ratiae volorro te reribus dolorer sperchicium faceata tiustia prat. 27 28 Itatur? Quiatae cullecum rem ent aut odis in re eossequodi nonsequ idebis ne sapicia is sinveli squiatum, core et que aut hariosam ex eat. 29 30 ## Blockquotes 31 32 The blockquote element represents content that is quoted from another source, optionally with a citation in a `cite` element, and optionally with in-line changes such as 33 annotations and abbreviations. 34 35 #### Blockquote without attribution 36 37 > Tiam, ad mint andaepu dandae nostion secatur sequo quae. 38 > **Note** that you can use *Markdown syntax* within a blockquote. 39 40 #### Blockquote with attribution 41 42 > It's really hard to think of text to put here, because there are so many dead memes that would disrupt the flow of this article. You should use this theme.<br/> 43 > — <cite>Big Chungus</cite> 44 45 ## Footnotes 46 47 Zola supports footnotes in Markdown via `pulldown-cmark`.[^1] Reference them in your content, and then write whatever you want at the bottom of the page. 48 49 ## Tables 50 51 Tables aren't part of the core Markdown spec, but Zola supports supports them out-of-the-box. 52 53 Name | Age 54 --------|------ 55 Bob | 27 56 Alice | 23 57 58 #### Inline Markdown within tables 59 60 | Italics | Bold | Code | 61 | -------- | -------- | ------ | 62 | *italics* | **bold** | `code` | 63 64 ## Code Blocks 65 66 #### Code block with backticks 67 68 ```html 69 <!doctype html> 70 <html lang="en"> 71 <head> 72 <meta charset="utf-8"> 73 <title>Example HTML5 Document</title> 74 </head> 75 <body> 76 <p>Test</p> 77 </body> 78 </html> 79 ``` 80 81 #### Code block indented with four spaces 82 83 <!doctype html> 84 <html lang="en"> 85 <head> 86 <meta charset="utf-8"> 87 <title>Example HTML5 Document</title> 88 </head> 89 <body> 90 <p>Test</p> 91 </body> 92 </html> 93 94 ## List Types 95 96 #### Ordered List 97 98 1. First item 99 2. Second item 100 3. Third item 101 102 #### Unordered List 103 104 * List item 105 * Another item 106 * And another item 107 108 #### Nested list 109 110 * Fruit 111 * Apple 112 * Orange 113 * Banana 114 * Dairy 115 * Milk 116 * Cheese 117 118 ## Other Elements — abbr, sub, sup, kbd, mark 119 120 <abbr title="Graphics Interchange Format">GIF</abbr> is a bitmap image format. 121 122 H<sub>2</sub>O 123 124 X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup> 125 126 Press <kbd>CTRL</kbd>+<kbd>ALT</kbd>+<kbd>Delete</kbd> to end the session. 127 128 Most <mark>salamanders</mark> are nocturnal, and hunt for insects, worms, and other small creatures. 129 130 --- 131 [^1]: [`pulldown-cmark`](https://github.com/raphlinus/pulldown-cmark) is a CommonMark parser written in Rust. For the time being, footnotes do not link back to the text they 132 began from. I expect this to change eventually, but it has to be implemented upstream from Zola. 133