Org mode syntax
and HTML export examples

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=
- +deleted text+ (vs. _inserted 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 an header row
| Name of column 1 | Name of column 2 | Name of column 3 |
|------------------+------------------+------------------|
| Top left         | Top middle       |                  |
|                  |                  | Right            |
| Bottom left      | Bottom middle    |                  |

| Name of column 1 | Name of column 2 | Name of column 3 |
|------------------+------------------+------------------|
|         Top left | Top middle       |                  |
|                2 |                  |                  |
|                3 |                  |                  |
|                4 |                  |                  |
|                5 |                  |                  |
|                6 |                  |                  |
|                7 |                  |                  |
|                8 |                  |                  |
|                9 |                  |                  |
|               10 |                  |                  |
|               11 |                  |                  |
|               12 |                  |                  |
|               13 |                  |                  |
|               14 |                  |                  |
|               15 |                  | Right            |
|               16 |                  |                  |
|               17 |                  |                  |
|               18 |                  |                  |
|               19 |                  |                  |
|               20 |                  |                  |
|               21 |                  |                  |
|               22 |                  |                  |
|               23 |                  |                  |
|               24 |                  |                  |
|               25 |                  |                  |
|               26 |                  |                  |
|               27 |                  |                  |
|               28 |                  |                  |
|               29 |                  |                  |
|      Bottom left | Bottom middle    |                  |

#+ATTR_HTML: :border 2 :rules all :frame border :style float:left;
| a | b |
| 1 | 2 |

#+ATTR_LATEX: :center nil
| a | b |
| 1 | 2 |

| a | b |
| 1 | 2 |

#+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
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, which can be exported:

#+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_EXAMPLE
You can include literal examples that should not be subjected to markup. Such
examples are typeset in monospace, so this is well suited for source code and
similar examples.
#+END_EXAMPLE

: Short examples can also be created with a colon and a space.

#+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_VERSE
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_VERSE

{{{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}.

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}+\cdots ,
\]

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-"

FIXME Delete this...