test/-syntax-block.md
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 |
# Block-level Formatting ## Headings Headings can be specified simply by prepending [#](class:kwd)s to text, as follows: # Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 ##### Heading 5 ###### Heading 6 > %note% > Note > > If you use [Document Headers](#Document-Headers), A [H1](class:kwd) is used for the title of the {{hs}} document. Within the document, start using headings from [H2](class:kwd). ## Tables {{hs}} supports [PHP Markdown Extra][pme] table syntax using pipes and dashes. {{input-text}} ~~~ Column Header 1 | Column Header 2 | Column Header 3 ----------------|-----------------|---------------- Cell 1,1 | Cell 1,2 | Cell 1, 3 Cell 2,1 | Cell 2,2 | Cell 2, 3 Cell 3,1 | Cell 3,2 | Cell 3, 3 ~~~ {{output-text}} Column Header 1 | Column Header 2 | Column Header 3 ----------------|-----------------|---------------- Cell 1,1 | Cell 1,2 | Cell 1, 3 Cell 2,1 | Cell 2,2 | Cell 2, 3 Cell 3,1 | Cell 3,2 | Cell 3, 3 > %note% > Note > > Multi-row cells are not supported. If you need more complex tables, use HTML code instead. > %sidebar% > Responsive Tables > > To make tables responsive, put them in a _responsive_ block, like in the previous example. The [responsive](class:kwd) class causes a table not to shrink and makes it scrollable horizontally on small devices. ## Block Quotes Block quotes can be created simply by prepending a [>](class:kwd) to a line, and they can be nested by prepending additional [>](class:kwd)s. {{input-text}} ~~~ > This is a block quote. > > This is a nested quote. ~~~ {{output-text}} > This is a block quote. > > This is a nested quote. ## Code Blocks To format a block of source code, indent it by at least four spaces. Here's the result: proc encode_image_file*(file, format): string = if (file.existsFile): let contents = file.readFile return encode_image(contents, format) else: echo("Warning: image '"& file &"' not found.") return file Alternatively, you can also use Github-style fenced blocks, by adding three tildes (~~~) or backticks (```) before and after the source code. > %warning% > Warning > > {{hs}} does not support syntax highlighting for code blocks. To do so, it would require Javascript and {{hs}} is currently kept purposedly "Javascript-free". ## Images {{input-text -> The following HastyScribe Markdown code:}} ~~~ ![HastyScribe Logo](./images/hastyscribe.png =221x65) ~~~ {{output-text -> Produces the following output:}} ![HastyScribe Logo](./images/hastyscribe.png =221x65) > %tip% > Tip > > You can use URL placeholders for images as well, exactly like for links. > %warning% > Limitations on automatic image download > > {{hs}} will attempt to download all HTTP image links. Note that: > > * If no response is received within 5 seconds, the download will be aborted. > * Connecting through a proxy is currently not supported. > * To download an image via HTTPS, you must explicitly recompile {{hs}} with [-d:ssl](class:kwd) and OpenSSL must be installed on your system. > > If {{hs}} is unable to download an image, it will leave it linked. {@ -syntax-block-lists.md || 1 @} {@ -syntax-block-classes.md || 1 @} |