Org-Mode Markup Kitchen Sink
Updated  2022-October-24

Page contents

 

News

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.

 

About this page

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!

 

Org-mode markup examples

Simple text formatting

  • bold
  • italic
  • underline
  • strike through
  • code
  • commands
small example

Within links:

This is an example of some syntax highlighting within links and such.

gnu


Five or more dashes produce a horizontal line.

 

Headings

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

 

Lists and Checkboxes

simple list:

  • Org-mode
  • Lists

enumerate:

  1. Emacs
  2. Org-mode
  3. Lists

mixed with checkboxes:

  • Clean out garage

    1. get stuff out

      • be careful with that axe, Eugene
    2. get rid of old stuff

      • sell on the Internet?
      • try to use rubbish as birthday presents for family
    3. repaint garage
    4. put stuff back in

 

Blocks

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

 

Comments

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:

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.

 

Links

 

Tables

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.

Heading1head2
entry42
foo21.7
end99.99

Don't worry about alignment if you don't have proper tool support. This is a perfectly valid table:

Heading1head2

More columns:

WhenWhatUSDEUR
2012-02-03Taxi Graz-Airport18.00
2012-02-03Taxi Seattle Airport25.0019.12
2012-02-13Taxi7.005.35
2012-02-14Taxi8.006.12
2012-02-17Taxi to Airport SeaTac35.0026.77
2012-02-22Taxi Airport-Graz16.00
91.36

Formatting:

Example
Orgdown
This is an example of some syntax highlighting.

 

Image

org-mode-unicorn.svg

 

Endnote


1

Many Infinite Ink articles, including this one, are evergreen and regularly updated.


Feedback 📝 🤔 👎 👍