Org mode syntax

By entering two consecutive backslashes, \\
you can force a line break
without starting a new paragraph.

For an horizontal line, insert at least 5 dashes: this is some text above an
horizontal rule
-----
and some text below it.

/Emphasize/ (italics), *strongly* (bold), and */very strongly/* (bold italics).

Markup elements can be nested:

This is /italic text which contains _underlined text_ within it/, whereas _this is
normal underlined text_.

Markup can span across multiple lines, but by default

*no more than
2 lines.*

*This
is not
bold.*

Org mode does not interpret a marker surrounded by alphanumeric characters as an
emphasis marker. So, you can't (easily) emphasize just part of a word:

Not feas*ible*.

To make the above case to work you'd have to quote with HTML tags:

This is feas@@html:<b>@@ible@@html:</b>@@.

- monospaced typewriter font for ~inline code~
- monospaced typewriter font for =verbatim text=
- +strikethrough text+ (vs. _underlined text_)
- text with super^{script}, such as 2^{10}
- text with sub_{script}, such as H_{2}O

- 'single quotes' to curly quotes,
- "straight quotes" to smart quotes,
- --- to em-dashes,
- -- to en-dashes,
- ... to ellipses and
- ' to typographic apostrophe.

- Item with some lengthy text wrapping hopefully across several lines. We add
  a few words to really show the line wrapping.
- Bullet.
  + Bullet.
    * Bullet.

- [X] Checked.
  + [-] Half-checked.
    * [ ] Not checked.

1. Arabic (decimal) numbered list item. We add a few words to show the line
   wrapping.
   A. Upper case alpha (letter) numbered list item.
      a. Lower alpha.
      b. Lower alpha.
   B. Upper alpha.
2. Number.

2. [@2] We start with point number 2.
3. Automatically numbered item.

- First term to define ::
     Definition of the first term. We add a few words to show the line wrapping,
     to see what happens when you have long lines.
- Second term ::
     Explication of the second term with *inline markup*.

     In many paragraphs.

1. apples
2. oranges
3. bananas
# comment
1. carrots
2. tomatoes
3. celery

- apples
- oranges
- bananas
\\
- carrots
- tomatoes
- celery

| Cell in column 1, row 1 | Cell in column 2, row 1 |
| Cell in column 1, row 2 | Cell in column 2, row 2 |

#+CAPTION: Table with aligned columns
|          <r>            | <c>                     | <l>                     |
|            1            | 2                       | 3                       |
|        Right            | Center                  | Left                    |
| Cell in column 1, row 3 | Cell in column 2, row 3 | Cell in column 1, row 3 |

#+CAPTION: Table with an header row
| Name of column 1 | Name of column 2 | Name of column 3 |
|------------------+------------------+------------------|
| Top left         | Top middle       |                  |
|                  |                  | Right            |
| Bottom left      | Bottom middle    |                  |

#+ATTR_HTML: :align left :border 2 :rules all :frame border
| a | b |
| 1 | 2 |

Normal text, Normal text, Normal text, Normal text, Normal text, Normal text, Normal text, Normal text,
Normal text, Normal text, Normal text, Normal text, Normal text, Normal text, Normal text, Normal text,
Normal text, Normal text, Normal text, Normal text, Normal text, Normal text, Normal text, Normal text,

#+ATTR_HTML: :width 100%
| Cell in column 1, row 1 | Cell in column 2, row 1 |
| Cell in column 1, row 2 | Cell in column 2, row 2 |

See http://www.pirilampo.org (automatic!) and the\\
[​[http://orgmode.org/][Org mode Web site]].

Images are simply shown with: [​[file:images/Org-mode-unicorn.svg]]

You can also point to an image with text link: [​[file:images/Org-mode-unicorn.svg][Unicorn picture]].

Images itself can also contain links, HTML-attributes, and a caption (figure), which will be automatically numbered and labeled. See Images in HTML export.

#+CAPTION: Taylor Series
#+ATTR_HTML: :alt Obligatory xkcd comic depicting complexity of Taylor series function :title The Taylor series should have been canceled after the first term.
[​[https://m.xkcd.com/2605/][file:images/taylor_series.png]]

#+begin_note
=/usr/bin/which=: this version of `which' is deprecated; use ~command -v~ in scripts instead.
#+end_note

#+begin_warning
Do not edit files in =/etc/sudoers.d= directly, but use ~visudo~. Otherwise
you risk locking out all your users!
#+end_warning

#+begin_comment
Regions surrounded by ‘#+BEGIN_COMMENT’ … ‘#+END_COMMENT’ are not HTML-exported.
See the actual comment yourself in source org-file, or exact usage in
org-manual.
#+end_comment

#+begin_abstract
In this Method of Increments, I consider quantities as increased by Increments or
diminished by Decrements, and between the given relations of the Integral [whole]
quantities, I seek the relations between the Increments, and from given relations between
Increments, I seek the Integral quantities themselves in turn. The uses of these methods in
mathematical matters is widely known ; and moreover it is shown to the greatest effect in
these circumstances where all the properties of Fluxions may hence be easily
derived.[...]
#+end_abstract

#+begin_left
This text is \\
aligned to the left!
#+end_left

#+begin_center
This text is \\
centered!
#+end_center

#+begin_right
This text is \\
aligned to the right!
#+end_right

#+BEGIN_EXAMPLE
#+BEGIN_EXAMPLEs don't subject to markup.
#+END_EXAMPLE

: Colon and a space also create a short example.

#+begin_quote
Let us change our traditional attitude to the construction of programs:
Instead of imagining that our main task is to instruct a computer what to do,
let us concentrate rather on explaining to human beings what we want a
computer to do.

The practitioner of literate programming can be regarded as an essayist, whose
main concern is with exposition and excellence of style. Such an author, with
thesaurus in hand, chooses the names of variables carefully and explains what
each variable means. He or she strives for a program that is comprehensible
because its concepts have been introduced in an order that is best for human
understanding, using a mixture of formal and informal methods that reinforce
each other.

-- Donald Knuth
#+end_quote

#+begin_verse
      Fatass Cartman was
  Not on the school bus today.
      What a big fat turd!
#+end_verse

#+MACRO: longtext-dish Lopado­temacho­selacho­galeo­kranio­leipsano­drim­hypo­trimmato­silphio­karabo­melito­katakechy­meno­kichl­epi­kossypho­phatto­perister­alektryon­opte­kephallio­kigklo­peleio­lagoio­siraio­baphe­tragano­pterygon

A fictional dish called {{{longtext-dish}}} was mentioned in Aristophanes' 391 B.C. comedy Assemblywomen.

{{{title}}}\\
{{{author}}}\\
{{{email}}}\\
{{{date}}}\\
{{{date("%Y-%m-%d")}}}\\
{{{time("%H:%M:%S")}}}\\

#+MACRO: color @@html:<span style="color: $1">$2</span>@@

{{{color(blue, This text is colored in blue.)}}}

{{{color(red, This other text is in red.)}}}

Keyboard macro:
Pressing {{{kbd(C-x)}}}{{{kbd(f)}}} -- means holding both Control /and/ x, release both, and press f.

#+begin_center
{{{bgcolor(red, DANGER! MINE FIELD!)}}}
#+end_center

Common color names are supported by most Org exporters (HTML, LaTeX):

{{{bgcolor(red, red)}}}
{{{bgcolor(orange, orange)}}}
{{{bgcolor(yellow, yellow)}}}
{{{bgcolor(green, green)}}}
{{{bgcolor(blue, blue)}}}
{{{bgcolor(purple, purple)}}}
{{{bgcolor(violet, violet)}}}

You can also use hexadecimal color codes:

{{{bgcolor(#FF0000, #FF0000)}}}
{{{bgcolor(#00FF00, #00FF00)}}}
{{{bgcolor(#0000FF, #0000FF)}}}

#+BEGIN_CENTER
How I love my coat of many colors.
It was {{{color(red, red)}}} and {{{color(yellow, yellow)}}} and {{{color(green, green)}}} and {{{color(brown, brown)}}},
And {{{color(#ff2d00, scarlet)}}} and {{{color(black, black)}}} and {{{color(#ff8f00, ocher)}}} and {{{color(#fd8340, peach)}}},
And {{{color(#ff003e, ruby)}}} and {{{color(olive, olive)}}} and {{{color(violet, violet)}}} and {{{color(#d18b10, fawn)}}}...
...And {{{color(#d399fa, lilac)}}} and {{{color(gold, gold)}}} and {{{color(chocolate, chocolate)}}} and {{{color(#663f56, mauve)}}},
And {{{color(#eed989, cream)}}} and {{{color(crimson, crimson)}}} and {{{color(silver, silver)}}} and {{{color(#ee89af, rose)}}},
And {{{color(azure, azure)}}} and {{{color(#ebf131, lemon)}}} and {{{color(#954b23, russet)}}} and {{{color(grey, grey)}}}...
...And {{{color(purple, purple)}}} and {{{color(white, white)}}} and {{{color(pink, pink)}}} and {{{color(orange, orange)}}},
And {{{color(red, red)}}} and {{{color(yellow, yellow)}}} and {{{color(green, green)}}} and {{{color(brown, brown)}}},
And {{{color(#ff2d00, scarlet)}}} and {{{color(black, black)}}} and {{{color(#ff8f00, ocher)}}} and {{{color(#fd8340, peach)}}},
#+END_CENTER

{{{hl(POLICE LINE DO NOT CROSS)}}}

{{{highlight(red, red)}}}
{{{highlight(orange, orange)}}}
{{{highlight(green, green)}}}
{{{highlight(blue, blue)}}}
{{{highlight(purple, purple)}}}
{{{highlight(violet, violet)}}}

{{{loremipsum}}}

- \Agrave \Aacute
- Dash: \ndash \mdash
- Marks: \iexcl \iquest
- Quotations: \laquo \raquo
- Miscellaneous: \para \ordf
- Currency: \cent \EUR \yen \pound
- The Greek letters \alpha, \beta, and \gamma are used to denote angles.
- Science: \pm \div
- Arrows: \to \rarr \larr \harr \rArr \lArr \hArr
- Function names: \arccos \cos
- Signs and symbols: \bull \star
- Smilies: \smiley \sad
- Suits: \clubs \spades
- [...]

#+BEGIN_EXPORT html
<td>
<ul>
<li>Using HTML entity to display &spades;</li>
<li>Using decimal to display &#9824;</li>
<li>Using hexadecimal to display &#x2660;</li>
</ul>
</td>
#+END_EXPORT

#+begin_src cpp -n -r
// Your First C++ "Hello World!"            (​ref:comment)

#include <iostream>                         (​ref:preprocessor)

int main() {                                (​ref:main)
    std::cout << "Hello World!";
    return 0;
}
#+end_src

Where,

~//~ denotes a comment on line [​[(comment)]]

The [​[(preprocessor)][~#include~]] is a preprocessor directive used to include files in our program.

~int main() {...}~: A valid C++ program must have the [​[(main)][main()]] function.

1: // Your First C++ "Hello World!"
2: 
3: include <iostream>
4: 
5: int main() {
6:     std::cout << "Hello World!";
7:     return 0;
8: }

You can also evaluate code inline as follows: 1 + 1 is src_R{1 + 1}.

      +-------+
      | Start |
      +---+---+
          |
          v
+-------------------+
|                   |
|                   |
|      Do you       |Yes                                        +------+Yes
|    understand     +------------------------------------------>| Good +-------------+
|   flow charts?    |                                           +------+             |
|  {c}              |                                               ^                |
|                   |                                               |                v                  +----------------+
+-------------------+                                               |          +------------+           |                |
          | No                                                      |          |            | 6 drinks  | Hey, I should  |
          |                                                         |          |   Let's go +---------->| try installing |
          |                                                         |          |   drink.   |           |   FreeBSD!     |
          v                                                         |          |            |           |                |
+-------------------+                    +-------------------+      |          +------------+           +----------------+
|                   |                    |                   |      |                ^
|                   |                    |                   |      |                |
|       Okay.       |Yes                 |  ...And you can   |Yes   |                |
|    You see the    +------------------->+    see the ones   +------+                |
|   line labeled    |                    |    labeled "no"?  |                 +-----+------+
|       "yes"? {c}  |                    |   {c}             |                 |  Screw it. |
|                   |                    |                   |                 +------------+
+-------------------+                    +---------+---------+                       ^
          | No                                     |No                               |
          |                                        v                                 |
          |                              +-------------------+                       |
          v                              |                   |                +------+-------+
+-------------------+                    |                   |                |              |
|                   |                    |      But you      |Yes             | (That wasn't |
|                   |       +-------+    |   just followed   +--------------->+ a question). |
|     But you       |Yes    |       |    |    them twice!    |                |              |
|   see the ones    +------>| Wait, |    |    {c}            |                +--------------+
|     labeled       |       | What? |    |                   |                       ^
|       "no"?       |       |       |    +---------+---------+                       |
|  {c}              |       +-------+              |No                               |
+---------+---------+                              +---------------------------------+
          |No           +--------+
          v             |        |
     +---------+        | I hate |
     | Listen. |------->|  you.  |
     +---------+        |        |
                        +--------+

    /-----------+        /---------\
    |    PLC    |        |         |
    |  Network  +<------>+   PLC   +<---=---------+
    |    cRED   |        |  c707   |              |
    +-----------/        \----+----/              |
                              ^                   |
                              |                   |
                              |  +----------------|-----------------+
                              |  |                |                 |
                              v  v                v                 v
      +----------+       +----+--+--+      +-------+---+      +-----+-----+       Windows clients
      |          |       |          |      |           |      |           |      +----+      +----+
      | Database +<----->+  Shared  +<---->+ Executive +<-=-->+ Operator  +<---->|cYEL| . . .|cYEL|
      | {s} cBLU |       |  Memory  |      | {io} cPNK |      | Server    |      |    |      |    |
      +--+----+--+       |{d} cGRE  |      +------+----+      |   c707    |      +----+      +----+
         ^    ^          +----------+             ^           +-------+---+
         |    |                                   |
         |    +--------=--------------------------+
         v
+--------+--------+
|                 |
| Millwide System |            -------- Data ---------
| cBLU            |            --=----- Signals ---=--
+-----------------+

The formula \(a^2 + b^2 = c^2\) has been discovered by Pythagoras.

Let \(a=\sin(x) + \cos(x)\). Then \(a^2 = 2\sin(x)\cos(x)\) because \(\sin^2x +
\cos^2x = 1\).

The /Taylor series:/

\[
f(a)+{\frac {f'(a)}{1!}}(x-a)+{\frac {f''(a)}{2!}}(x-a)^{2}+{\frac {f'''(a)}{3!}}(x-a)^{3}+
\]

where /n!/ denotes the factorial of /n/. In the more compact sigma notation, this can be written as

\[ \sum _{n=0}^{\infty }{\frac {f^{(n)}(a)}{n!}}(x-a)^{n} \]

#+INCLUDE: "chapter1.org" :lines "2-"

** DONE [#A] H2 Title with closed DONE state, priority and a tag  :online:
:LOGBOOK:
   - State "TODO"        ->  "DONE"       [2014-01-16 Thu 09:52]
:END:

By default, DONE-actions will be collapsed and drawers (notice ~:LOGBOOK:~
in Org code block?) are not exported to HTML, unless =#+OPTIONS: d:t= is
defined.

[​[https://orgmode.org/manual/Priorities.html][Priority]] is displayed if =#+OPTIONS: pri:t= or priority cookie =(org-export-with-priority)= is set.

*** FOLLOWUP [#B] H3 Title with different TODO state, priority and several tags  :computer:write:

**** NEXT [#C] H4 title with closed TODO state and priority