2022-October-18 Soft launched this evolving1 article.
ℹ | An Infinite Ink article that is soft launched is a work in progress and is not listed on Infinite Ink’s home page or Hugo-generated sitemap. |
I'm using this page to test using Org-mode markup in the source of an article that is generated by the Hugo static site generator with the help of go-org, which is one of Hugo's built-in renderers. Most of the examples below were forked from Karl Voit's gitlab.com/publicvoit/orgdown/-/blob/master/doc/Orgdown1-Syntax-Examples.org – thank you Karl!
code
commands
small example
Within links:
This is an example of some syntax highlighting within links
and such
.
Five or more dashes produce a horizontal line.
Headings are pre-pended by a set of asterisk characters followed by at least one space character.
One asterisk is a heading of level 1, two asterisks for level 2 and so forth:
* Heading of level 1 ** Heading of level 2 *** Heading of level 3 *** Another heading of level 3 ** Again a heading of level 2
simple list:
enumerate:
mixed with checkboxes:
Clean out garage
get stuff out
get rid of old stuff
An EXAMPLE block is rendered as is, keeping line breaks and not interpreting content:
An example in an EXAMPLE block. Second line within this block. This *is* an /example/ of _some_ syntax +highlighting+.
Content within a QUOTE block may get different line breaks when exported/rendered and interprets Orgdown text formatting:
An example in an QUOTE block. Second line within this block.
This is an example of some syntax
highlighting.
VERSE blocks are similar to quote blocks, but they respect line breaks:
An example in an VERSE block. Second line within this block.
This is an example of some syntax highlighting.
SRC blocks contain source code snippets. Text formatting is ignored, line breaks preserved.
A Python source code example:
def my_test(myvar: str = 'foo bar'):
"""
This is an example function.
@type myvar: str = 'foo bar': number
@param myvar: str = 'foo bar': FIXXME
"""
mynewvar: str = myvar + ' additional content'
return mynewvar
print("Hello " + my_text('Europe!'))
A shell script example:
echo "Hello Europe!"
FOO="foo bar"
echo "A test with ${FOO}"
pwd
Comment lines contain content which is not visible in any derived document, such as a PDF document or a web view.
hash space:
space hash space:
space space hash space:
Comment block:
Tables do not have to be properly aligned. As long as the correct number of vertical bars per line is met, text formatting is applied.
Heading1 | head2 |
---|---|
entry | 42 |
foo | 21.7 |
end | 99.99 |
Don't worry about alignment if you don't have proper tool support. This is a perfectly valid table:
Heading1 | head2 |
---|
More columns:
When | What | USD | EUR |
---|---|---|---|
2012-02-03 | Taxi Graz-Airport | 18.00 | |
2012-02-03 | Taxi Seattle Airport | 25.00 | 19.12 |
2012-02-13 | Taxi | 7.00 | 5.35 |
2012-02-14 | Taxi | 8.00 | 6.12 |
2012-02-17 | Taxi to Airport SeaTac | 35.00 | 26.77 |
2012-02-22 | Taxi Airport-Graz | 16.00 | |
91.36 |
Formatting:
Example |
---|
Orgdown |
This is an example of some syntax |
Many Infinite Ink articles, including this one, are evergreen and regularly updated.
@nm@mathstodon.xyz
or
#InfiniteInk
in it.
This is a multi line comment block. This is the second line.
This is the second paragraph.
This is an example of some syntax
highlighting.