Advanced Formatting

The Trunk Notes Manual

Trunknotes uses Markdown for formatting documents, but it also supports a number of advanced formatting features that either are not described in Docs:MarkdownSyntax or are not part of the base Markdown specification.

This page is based on http://daringfireball.net/projects/markdown/syntax and http://michelf.com/projects/php-markdown/extra/

Setext Headings

Rather than using # and ## at the beginning of a line for headings, you can use setext style headings. Setext-style headings for <h1> and <h2> are created by underlining with equal signs (=) and hyphens (-), respectively. For h3 or greater you still must use ###.

A First Level Header
====================
A Second Level Header
---------------------
### Header 3

HTML Entity Conversion

Trunk Notes supports SmartyPants conversion of straight quotes to curly quotes, as well as some other useful text to HTML entity conversions.

  • Straight quotes ( " and ' ) are converted into “curly” quote entities
  • Backticks-style quotes (``like this'') also are converted into ``curly’’ quote entities
  • A single quote at the end of a word such as don't is properly converted to the apostrophe entity in “don’t”, but foo'tbar keeps the straight quote as “foo’tbar”.
  • Dashes (-- and ---) into en-dash - and em-dash — entities
  • A single dash surrounded by spaces - becomes the hyphen entity – , but A-B remains A-B.
  • Three consecutive dots (...) and (. . .) into an ellipsis “…” entity
  • (tm) becomes “(tm)”
  • (r)becomes “(r)”
  • (c) becomes “(c)”
  • 1/4 becomes “1/4”, 1/2 becomes “1/2”, 3/4 becomes “3/4”, and 3/4 becomes “3/4”.
  • You can escape these entities conversions with a backslash, i.e. \(c) displays as "“(c)”".

Escaping

Backslash (\) escapes the following characters: \ * _ { } # + - . ! `, i.e. \*this text is surrounded by literal asterisks\* displays as “*this text is surrounded by literal asterisks*”. You can also use the backslash to escape HTML entity conversion.

Use a backslash after a number to avoid accidental numbered lists, i.e.:

1918\. What a great season.

1918. What a great season.

Code

Single backticks format and auto-escape &, < and > in code like <blink>, — and —.

Preformatted code is also easy

<strong>Indent 4 spaces</strong>

You can also use the <pre> HTML entity. Ensure that <pre> and corresponding </pre> are both at the start of a line. For example

<pre>
Some text
</pre>

If you need to display a backtick inside of code,you can use multiple backticks as the opening and closing delimiters, i.e.

``There is a literal
backtick (`) here.``

becomes “There is a literal backtick (`) here.”

Alternative Hyperlink Forms

In addition to /[[WikiLinks]] and standard inline links [Google](http://www.google.com/), Trunk Notes also supports

* Reference-style links:*

[Apps On The Move][1]

Elsewhere on the page: 

[1]: http://www.appsonthemove.com

* A more readable reference link:*

[Google][google]

Elsewhere on the page: 

[Google]: http://www.google.com

* Standard HTML hyperlinks:*

<a href="http://appsonthemove.com/">Apps On The Move</a>

* Automatically converted hyperlinks:*

http://www.appsonthemove.com

Forced hyperlinks:

<http://www.appsonthemove.com>

Tables

Trunk Notes supports simple tables. The first line contains the labels for the table with the pipe | character as a separator. The following line is a seperator line with hyphens ---- also separated by the pipe | character as a separator. Finally multiple rows of cells, all with the with the pipe | character as a separator:

First Header  | Second Header
------------- | -------------
Content Cell  | Content Cell
Content Cell  | Content Cell
First Header Second Header
Content Cell Content Cell
Content Cell Content Cell

You can specify alignment for each column by adding colons to separator lines. A colon at the left of the separator line will make the column left-aligned; a colon on the right of the line will make the column right-aligned; colons at both side means the column is center-aligned.

Item      | Page  | Price
:-------- | :---: | -----:
Computer  | 1     | $1600
Phone     | 2     | $12
Pipe      | 3     | $1
Item Page Price
Computer 1 $1600
Phone 2 $12
Pipe 3 $1

You can also use Markdown syntax inside each cell:

Function name | Description
------------- | --------------------------
`help()`      | Display the help window.
`destroy()`   | **Destroy your computer!**
Function name Description
help() Display the help window.
destroy() Destroy your computer!

Center Paragraphs

You can center a paragraph by starting it with -> and ending with <-, i.e.

->this is a test<-

becomes…

this is a test

Image Resizing

The size of an image can be specified by adding an additional =widthxheight field to the image tag.

  • Default (175x175):
![Trunk Notes Icon](/assets/icon175x175.png)
  • Half-size (50x50):
![Trunk Notes Icon](/assets/icon175x175.png =50x50)