Markdown Syntax Documentation (for the Wiki)

Philosophy

Markdown is intended to be as easy-to-read and easy-to-write as is feasible.

Readability, however, is emphasized above all else. A Markdown-formatted document should be publishable as-is, as plain text, without looking like it’s been marked up with tags or formatting instructions.

To this end, Markdown’s syntax is comprised entirely of punctuation characters, which punctuation characters have been carefully chosen so as to look like what they mean.

Headers

Headers are denoted in two different ways:

Adding any number of equals signs (H1) or hyphens (H2) to a new line after your intended header.

javascript: Copy To Clipboard
This is an H1
=============
 
This is an H2
-------------

You may also use Atx headers through the use of hashes (#) any number from 1-6. These are added at the start of the line

javascript: Copy To Clipboard
# This is an H1
 
## This is an H2
 
###### This is an H6

note that you may optionally "close" these atx headers for cosmetic purposes

javascript: Copy To Clipboard
# This is an H1 #
 
## This is an H2 ##
 
###### This is an H6 ######

Text Formatting

Markdown Markup Standard

Markdown treats asterisks (*) and underscores (_) as indicators of emphasis. Text wrapped with one asterisks or underscores will be wrapped with an HTML <em> tag; double asterisks or underscores will be wrapped with an HTML <strong> tag. E.g., this input:

javascript: Copy To Clipboard
*single asterisks*
 
_single underscores_
 
**double asterisks**
 
__double underscores__

will produce:

single asterisks

single underscores

double asterisks

double underscores

You can use whichever style you prefer; the lone restriction is that the same character must be used to open and close an emphasis span.

Emphasis can be used in the middle of a word:

javascript: Copy To Clipboard
un*frigging*believable

But if you surround an * or _ with spaces, it’ll be treated as a literal asterisk or underscore.

To produce a literal asterisk or underscore at a position where it would otherwise be used as an emphasis delimiter, you can backslash escape it:

javascript: Copy To Clipboard
\*this text is surrounded by literal asterisks\*

Custom Buttons² Wiki Specific

The following have been added for text formatting since we believe they are needed.

javascript: Copy To Clipboard
! !double exclamations! !  
~ ~double tildes~ ~

* without the spaces

which produce:

double exclamations

double tildes

Blockquoting

Markdown uses email-style > characters for blockquoting. Simply place a > at the beginning of a line to indicate a quote.

javascript: Copy To Clipboard
&gt; This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
&gt; consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
&gt; Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
&gt; 
&gt; Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
&gt; id sem consectetuer libero luctus adipiscing.

You may also opt to only use the > at the beginning of hard-wrapped paragraphs:

javascript: Copy To Clipboard
&gt; This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
 
&gt; Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.

You may also have nested quotes:

javascript: Copy To Clipboard
&gt; This is the first level of quoting.
&gt;
&gt; &gt; This is nested blockquote.
&gt;
&gt; Back to the first level.

Blockquotes can contain other Markdown elements, including headers, lists, and code blocks:

javascript: Copy To Clipboard
&gt; ## This is a header.
&gt; 
&gt; 1.   This is the first list item.
&gt; 2.   This is the second list item.
&gt; 
&gt; Here's some example code:
&gt; 
&gt;     return shell_exec("echo $input | $markdown_script");

Lists

Unordered

Unordered lists use asterisks, pluses, and hyphens — interchangably — as list markers:

javascript: Copy To Clipboard
*   Red
*   Green
*   Blue

is equivalent to:

javascript: Copy To Clipboard
+   Red
+   Green
+   Blue

and:

javascript: Copy To Clipboard
-   Red
-   Green
-   Blue

Ordered

Ordered lists use numbers followed by periods:

javascript: Copy To Clipboard
1.  Bird
2.  McHale
3.  Parish

It’s important to note that the actual numbers you use to mark the list have no effect on the HTML output Markdown produces. If you instead wrote the list in Markdown like this:

javascript: Copy To Clipboard
1.  Bird
1.  McHale
1.  Parish

or even:

javascript: Copy To Clipboard
3. Bird
1. McHale
8. Parish

You would get the same list every time. The point is to be able to use ordinal numbers for readability in the source even though they aren't typically used in source code.

If you do use lazy list numbering, however, you should still start the list with the number 1. At some point in the future, Markdown may support starting ordered lists at an arbitrary number.

List markers typically start at the left margin, but may be indented by up to three spaces. List markers must be followed by one or more spaces or a tab.

To make lists look nice, you can wrap items with hanging indents:

javascript: Copy To Clipboard
*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
    Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
    viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
    Suspendisse id sem consectetuer libero luctus adipiscing.

But if you want to be lazy, you don’t have to:

javascript: Copy To Clipboard
*   Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
*   Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.

If list items are separated by blank lines, Markdown will wrap the items in <p> tags in the HTML output. For example, this input:

javascript: Copy To Clipboard
*   Bird
*   Magic

will turn into:

javascript: Copy To Clipboard
&lt;ul&gt;
&lt;li&gt;Bird&lt;/li&gt;
&lt;li&gt;Magic&lt;/li&gt;
&lt;/ul&gt;

But this:

javascript: Copy To Clipboard
*   Bird
 
*   Magic

will turn into:

javascript: Copy To Clipboard
&lt;ul&gt;
&lt;li&gt;&lt;p&gt;Bird&lt;/p&gt;&lt;/li&gt;
&lt;li&gt;&lt;p&gt;Magic&lt;/p&gt;&lt;/li&gt;
&lt;/ul&gt;

List items may consist of multiple paragraphs. Each subsequent paragraph in a list item must be indented by either 4 spaces or one tab:

javascript: Copy To Clipboard
1.  This is a list item with two paragraphs. Lorem ipsum dolor
    sit amet, consectetuer adipiscing elit. Aliquam hendrerit
    mi posuere lectus.
 
    Vestibulum enim wisi, viverra nec, fringilla in, laoreet
    vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
    sit amet velit.
 
2.  Suspendisse id sem consectetuer libero luctus adipiscing.

It looks nice if you indent every line of the subsequent paragraphs, but here again, Markdown will allow you to be lazy:

javascript: Copy To Clipboard
*   This is a list item with two paragraphs.
 
    This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.
 
*   Another item in the same list.

To put blockquotes within a list item, the blockquote needs to be indented twice — 8 spaces or two tabs:

javascript: Copy To Clipboard
*   A list item with a blockquote:
 
    &gt; This is a blockquote
    &gt; inside a list item.

To put a code block within a list item, the code block needs to be indented twice — 8 spaces or two tabs:

javascript: Copy To Clipboard
*   A list item with a code block:
 
        &lt;div class="selectall"&gt;javascript: &lt;a class="selectall"&gt;Copy To Clipboard&lt;/a&gt;&lt;/div&gt;&lt;div class="geshifilter"&gt;&lt;pre class="geshifilter-javascript"&gt;~~~
&amp;nbsp;
It’s worth noting that it’s possible to trigger an ordered list by accident, by writing something like &lt;span style="color: #000066; font-weight: bold;"&gt;this&lt;/span&gt;:
&amp;nbsp;

1986. What a great season.

javascript: Copy To Clipboard
&amp;nbsp;
&lt;span style="color: #000066; font-weight: bold;"&gt;In&lt;/span&gt; other words, a number-period-space sequence at the beginning of a line. &lt;span style="color: #006600;"&gt;To&lt;/span&gt; avoid &lt;span style="color: #000066; font-weight: bold;"&gt;this&lt;/span&gt;, you can backslash-escape the period:
&amp;nbsp;

1986. What a great season.

javascript: Copy To Clipboard
&amp;nbsp;
## Definition Lists
&amp;nbsp;
Definition lists are made of terms and definitions of these terms, much like &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; a dictionary.
&amp;nbsp;
&lt;span style="color: #006600;"&gt;A&lt;/span&gt; simple definition list &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; Markdown &lt;span style="color: #000066; font-weight: bold;"&gt;is&lt;/span&gt; made of a single-line term followed by a colon and the definition &lt;span style="color: #000066; font-weight: bold;"&gt;for&lt;/span&gt; that term.
&amp;nbsp;
Apple
Pomaceous fruit of plants of the genus Malus in the family Rosaceae.   Orange
The fruit of an evergreen tree of the genus Citrus.
javascript: Copy To Clipboard
&amp;nbsp;
Terms must be separated from the previous definition by a blank line. &lt;span style="color: #006600;"&gt;Definitions&lt;/span&gt; can span on multiple lines, &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; which &lt;span style="color: #000066; font-weight: bold;"&gt;case&lt;/span&gt; they should be indented. &lt;span style="color: #006600;"&gt;But&lt;/span&gt; you don’t really have to: &lt;span style="color: #000066; font-weight: bold;"&gt;if&lt;/span&gt; you want to be lazy, you could forget to indent a definition that span on multiple lines and it will still work:
&amp;nbsp;
Apple
Pomaceous fruit of plants of the genus Malus in   the family Rosaceae.     Orange
The fruit of an evergreen tree of the genus Citrus.
javascript: Copy To Clipboard
&amp;nbsp;
Each of the preceding definition lists will give the same HTML result:
&amp;nbsp;

<dl> <dt>Apple</dt> <dd>Pomaceous fruit of plants of the genus Malus in the family Rosaceae.</dd>   <dt>Orange</dt> <dd>The fruit of an evergreen tree of the genus Citrus.</dd> </dl>

javascript: Copy To Clipboard
&amp;nbsp;
Colons &lt;span style="color: #000066; font-weight: bold;"&gt;as&lt;/span&gt; definition markers typically start at the left margin, but may be indented by up to three spaces. &lt;span style="color: #006600;"&gt;Definition&lt;/span&gt; markers must be followed by one or more spaces or a tab.
&amp;nbsp;
&lt;span style="color: #006600;"&gt;Definition&lt;/span&gt; lists can have more than one definition associated &lt;span style="color: #000066; font-weight: bold;"&gt;with&lt;/span&gt; one term:
&amp;nbsp;
Apple
Pomaceous fruit of plants of the genus Malus in the family Rosaceae.
An american computer company.   Orange
The fruit of an evergreen tree of the genus Citrus.
javascript: Copy To Clipboard
&amp;nbsp;
You can also associate more than one term to a definition:
&amp;nbsp;
Term 1
Term 2
Definition a   Term 3
Definition b
javascript: Copy To Clipboard
&amp;nbsp;
&lt;span style="color: #000066; font-weight: bold;"&gt;If&lt;/span&gt; a definition &lt;span style="color: #000066; font-weight: bold;"&gt;is&lt;/span&gt; preceded by a blank line, Markdown will wrap the definition &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; `&lt;span style="color: #66cc66;"&gt;&amp;lt;&lt;/span&gt;p&lt;span style="color: #66cc66;"&gt;&amp;gt;&lt;/span&gt;` tags &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; the HTML output. &lt;span style="color: #000066; font-weight: bold;"&gt;For&lt;/span&gt; example, &lt;span style="color: #000066; font-weight: bold;"&gt;this&lt;/span&gt;:
&amp;nbsp;
Apple
 
Pomaceous fruit of plants of the genus Malus in the family Rosaceae.   Orange  
The fruit of an evergreen tree of the genus Citrus.
javascript: Copy To Clipboard
&amp;nbsp;
will turn into &lt;span style="color: #000066; font-weight: bold;"&gt;this&lt;/span&gt;:
&amp;nbsp;

<dl> <dt>Apple</dt> <dd> <p>Pomaceous fruit of plants of the genus Malus in the family Rosaceae.</p> </dd>   <dt>Orange</dt> <dd> <p>The fruit of an evergreen tree of the genus Citrus.</p> </dd> </dl>

javascript: Copy To Clipboard
&amp;nbsp;
And just like regular list items, definitions can contain multiple paragraphs, and include other block-level elements such &lt;span style="color: #000066; font-weight: bold;"&gt;as&lt;/span&gt; blockquotes, code blocks, lists, and even other definition lists.
&amp;nbsp;
Term 1
 
This is a definition with two paragraphs. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.   Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.  
Second definition for term 1, also wrapped in a paragraph because of the blank line preceding it.   Term 2  
This definition has a code block, a blockquote and a list.   code block.   > block quote > on two lines.   1. first list item 2. second list item
javascript: Copy To Clipboard
&amp;nbsp;
## Footnotes
&amp;nbsp;
Footnotes work mostly like reference-style links. &lt;span style="color: #006600;"&gt;A&lt;/span&gt; footnote &lt;span style="color: #000066; font-weight: bold;"&gt;is&lt;/span&gt; made of two things: a marker &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; the text that will become a superscript number; a footnote definition that will be placed &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; a list of footnotes at the end of the document. &lt;span style="color: #006600;"&gt;A&lt;/span&gt; footnote looks like &lt;span style="color: #000066; font-weight: bold;"&gt;this&lt;/span&gt;:
&amp;nbsp;

That's some text with a footnote.1  

javascript: Copy To Clipboard
&amp;nbsp;
Footnote definitions can be found anywhere &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; the document, but footnotes will always be listed &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; the order they are linked to &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; the text. &lt;span style="color: #006600;"&gt;Note&lt;/span&gt; that you cannot make two links to the same footnotes: &lt;span style="color: #000066; font-weight: bold;"&gt;if&lt;/span&gt; you &lt;span style="color: #000066; font-weight: bold;"&gt;try&lt;/span&gt;, the second footnote reference will be left &lt;span style="color: #000066; font-weight: bold;"&gt;as&lt;/span&gt; plain text.
&amp;nbsp;
&lt;span style="color: #006600;"&gt;Each&lt;/span&gt; footnote must have a distinct &lt;span style="color: #000066;"&gt;name&lt;/span&gt;. &lt;span style="color: #006600;"&gt;That&lt;/span&gt; &lt;span style="color: #000066;"&gt;name&lt;/span&gt; will be used to link footnote references to footnote definitions, but has no effect on the numbering of the footnotes. &lt;span style="color: #006600;"&gt;Names&lt;/span&gt; can contain any character valid within an id attribute &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; HTML.
&amp;nbsp;
&lt;span style="color: #006600;"&gt;Footnotes&lt;/span&gt; can contain block-level elements, which means that you can put multiple paragraphs, lists, blockquotes and so on &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; a footnote. &lt;span style="color: #006600;"&gt;It&lt;/span&gt; works the same &lt;span style="color: #000066; font-weight: bold;"&gt;as&lt;/span&gt; &lt;span style="color: #000066; font-weight: bold;"&gt;for&lt;/span&gt; list items: just indent the following paragraphs by four spaces &lt;span style="color: #000066; font-weight: bold;"&gt;in&lt;/span&gt; the footnote definition:
&amp;nbsp;

That's some text with a footnote.[^1]  

javascript: Copy To Clipboard
&amp;nbsp;
If you want things to align better, you can leave the first line of the footnote empty and put your first paragraph just below:
&amp;nbsp;
javascript: Copy To Clipboard
&amp;nbsp;
## Abbreviations
&amp;nbsp;
Markdown adds supports for abbreviations (HTML tag `&amp;lt;abbr&amp;gt;`). How it works is pretty simple: create an abbreviation definition like this:
&amp;nbsp;
javascript: Copy To Clipboard
&amp;nbsp;
then, elsewhere in the document, write text such as:
&amp;nbsp;

The HTML specification is maintained by the W3C.

javascript: Copy To Clipboard
&amp;nbsp;
and any instance of those words in the text will become:
&amp;nbsp;

The <abbr title="Hyper Text Markup Language">HTML</abbr> specification is maintained by the <abbr title="World Wide Web Consortium">W3C</abbr>.

javascript: Copy To Clipboard
&amp;nbsp;
Abbreviation are case-sensitive, and will span on multiple words when defined as such. An abbreviation may also have an empty definition, in which case `&amp;lt;abbr&amp;gt;` tags will be added in the text but the title attribute will be omitted.
&amp;nbsp;

Operation Tigra Genesis is going well.  

javascript: Copy To Clipboard
&amp;nbsp;
Abbreviation definition can be anywhere in the document. They are stripped from the final document.
&amp;nbsp;
## Tables
&amp;nbsp;
First line contains column headers; second line contains a mandatory separator line between the headers and the content; each following line is a row in the table. Columns are always separated by the pipe (|) character. Once converted to HTML, the result is like this:
&amp;nbsp;
First Header Second Header
Content Cell Content Cell
Content Cell Content Cell
javascript: Copy To Clipboard
&amp;nbsp;
If you wish, you can add a leading and tailing pipe to each line of the table. Use the form that you like. As an illustration, this will give the same result as above:
&amp;nbsp;
First Header Second Header
Content Cell Content Cell
Content Cell Content Cell
javascript: Copy To Clipboard
&amp;nbsp;
Note: A table need at least one pipe on each line for Markdown to parse it correctly. This means that the only way to create a one-column table is to add a leading or a tailing pipe, or both of them, to each line.
&amp;nbsp;
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.
&amp;nbsp;
Item Value
Computer $1600
Phone $12
Pipe $1
javascript: Copy To Clipboard
&amp;nbsp;
## Code
&amp;nbsp;
### Codeblocks
&amp;nbsp;
Markdown wraps a code block in both pre and code tags.
&amp;nbsp;
To produce a code block in Markdown, simply indent every line of the block by at least 4 spaces or 1 tab. For example, given this input:
&amp;nbsp;

This is a normal paragraph:   This is a code block.

javascript: Copy To Clipboard
&amp;nbsp;
Markdown will generate:
&amp;nbsp;

<p>This is a normal paragraph:</p>   <pre><code>This is a code block.

javascript: Copy To Clipboard
<br />Note that one level of indentation — 4 spaces or 1 tab — is removed from each line.
 
A code block continues until it reaches a line that is not indented (or the end of the article).
 
Regular Markdown syntax is not processed within code blocks. E.g., asterisks are just literal asterisks within a code block. This means it’s also easy to use Markdown to write about Markdown’s own syntax.
 
Alternatively, you may use fenced codeblocks.  Fenced code blocks are like Markdown’s regular code blocks, except that they’re not indented and instead rely on a start and end fence lines to delimit the code block. The code block start with a line containing three or more tilde ~ characters, and ends with the first line with the same number of tilde ~. For instance:
 
    ~~~
    a one-line code block
    ~~~
 
These fenced code blocks are more reliable and most likely easier to use.
 
 
### Code (inline)
 
To indicate a span of code, wrap it with backtick quotes (\`). Unlike a pre-formatted code block, a code span indicates code within a normal paragraph. For example:

Use the printf() function.

javascript: Copy To Clipboard
<br />will produce:

Use the printf() function.

javascript: Copy To Clipboard
<br />To include a literal backtick character within a code span, you can use multiple backticks as the opening and closing delimiters:

There is a literal backtick (`) here.

javascript: Copy To Clipboard
<br />which will produce this:

There is a literal backtick (`) here.

javascript: Copy To Clipboard
<br />The backtick delimiters surrounding a code span may include spaces — one after the opening, one before the closing. This allows you to place literal backtick characters at the beginning or end of a code span:

A single backtick in a code span: `

A backtick-delimited string in a code span: `foo`

javascript: Copy To Clipboard
<br />will produce:

A single backtick in a code span: `

A backtick-delimited string in a code span: foo

javascript: Copy To Clipboard
<br />With a code span, ampersands and angle brackets are encoded as HTML entities automatically, which makes it easy to include example HTML tags. Markdown will turn this:

Please don't use any <blink> tags.

javascript: Copy To Clipboard
<br />into:

Please don't use any &lt;blink&gt; tags.

javascript: Copy To Clipboard
<br />You can write this:

&#8212; is the decimal-encoded equivalent of &mdash;.

javascript: Copy To Clipboard
<br />to produce:

&amp;#8212; is the decimal-encoded equivalent of &amp;mdash;.

javascript: Copy To Clipboard
<br />## Horizontal Rules
 
 
You can produce a horizontal rule tag (hr) by placing three or more hyphens, asterisks, or underscores on a line by themselves.





javascript: Copy To Clipboard
<br />## Links
 
Markdown supports two style of links: inline and reference.
 
In both styles, the link text is delimited by [square brackets].
 
### Inline Links
 
To create an inline link, use a set of regular parentheses immediately after the link text’s closing square bracket. Inside the parentheses, put the URL where you want the link to point, along with an optional title for the link, surrounded in quotes. For example:

This is an example inline link.

This link has no title attribute.

javascript: Copy To Clipboard
<br />If you’re referring to a local resource on the same server, you can use relative paths:

See my About page for details.

javascript: Copy To Clipboard
<br />### Reference Links
 
Reference-style links use a second set of square brackets, inside which you place a label of your choosing to identify the link:

This is an example reference-style link.

javascript: Copy To Clipboard
<br />You can optionally use a space to separate the sets of brackets:

This is an example reference-style link.

javascript: Copy To Clipboard
<br />Then, anywhere in the document, you define your link label like this, on a line by itself:
javascript: Copy To Clipboard
<br />That is:
 
* Square brackets containing the link identifier (optionally indented from the left margin using up to three spaces);
* followed by a colon;
* followed by one or more spaces (or tabs);
* followed by the URL for the link;
* optionally followed by a title attribute for the link, enclosed in double or single quotes, or enclosed in parentheses.
 
The following three link definitions are equivalent:

[foo]: http://example.com/ 'Optional Title Here'

javascript: Copy To Clipboard
<br />The link URL may, optionally, be surrounded by angle brackets:

javascript: Copy To Clipboard
<br />You can put the title attribute on the next line and use extra spaces or tabs for padding, which tends to look better with longer URLs:
javascript: Copy To Clipboard
<br />Link definitions are only used for creating links during Markdown processing, and are stripped from your document in the HTML output.
 
Link definition names may consist of letters, numbers, spaces, and punctuation — but they are not case sensitive. E.g. these two links:

[link text][a] [link text][A]

javascript: Copy To Clipboard
<br />are equivalent.
 
The implicit link name shortcut allows you to omit the name of the link, in which case the link text itself is used as the name. Just use an empty set of square brackets — e.g., to link the word “Google” to the google.com web site, you could simply write:

Google

javascript: Copy To Clipboard
<br />And then define the link:
javascript: Copy To Clipboard
<br />Because link names may contain spaces, this shortcut even works for multiple words in the link text:

Visit Custom Buttons² for more information.

javascript: Copy To Clipboard
<br />And then define the link:
javascript: Copy To Clipboard
<br />Link definitions can be placed anywhere in your Markdown document. I tend to put them immediately after each paragraph in which they’re used, but if you want, you can put them all at the end of your document, sort of like footnotes.
 
Here’s an example of reference links in action:

I get 10 times more traffic from Google than from Yahoo or MSN.

javascript: Copy To Clipboard
<br />Using the implicit link name shortcut, you could instead write:

I get 10 times more traffic from Google than from Yahoo or MSN.

javascript: Copy To Clipboard
<br />Both of the above examples will produce the following HTML output:
 
&gt;I get 10 times more traffic from [Google][] than from
&gt;[Yahoo][] or [MSN][].
&gt;
&gt;[google]: http://google.com/        "Google"
&gt;[yahoo]:  http://search.yahoo.com/  "Yahoo Search"
&gt;[msn]:    http://search.msn.com/    "MSN Search"
 
For comparison, here is the same paragraph written using Markdown’s inline link style:

I get 10 times more traffic from Google than from Yahoo or MSN.

javascript: Copy To Clipboard
<br />The point of reference-style links is not that they’re easier to write. The point is that with reference-style links, your document source is vastly more readable. Compare the above examples: using reference-style links, the paragraph itself is only 81 characters long; with inline-style links, it’s 176 characters; and as raw HTML, it’s 234 characters. In the raw HTML, there’s more markup than there is text.
 
With Markdown’s reference-style links, a source document much more closely resembles the final output, as rendered in a browser. By allowing you to move the markup-related metadata out of the paragraph, you can add links without interrupting the narrative flow of your prose.
 
### Automatic Links
 
Markdown supports a shortcut style for creating “automatic” links for URLs and email addresses: simply surround the URL or email address with angle brackets. What this means is that if you want to show the actual text of a URL or email address, and also have it be a clickable link, you can do this:

http://example.com/

javascript: Copy To Clipboard
<br />Markdown will turn this into:

http://example.com/

javascript: Copy To Clipboard
<br />Automatic links for email addresses work similarly:

address@example.com

javascript: Copy To Clipboard
<br />which will render in a browser as a clickable link to “address@example.com”.
 
This is all fine and dandy but address-harvesting bots will most likely harvest your email so be careful.
 
## Images
 
Admittedly, it’s fairly difficult to devise a “natural” syntax for placing images into a plain text document format.
 
Markdown uses an image syntax that is intended to resemble the syntax for links, allowing for two styles: inline and reference.
 
Inline image syntax looks like this:

Alt text

Alt text

javascript: Copy To Clipboard
<br />That is:
 
* An exclamation mark: !;
* followed by a set of square brackets, containing the alt attribute text for the image;
* followed by a set of parentheses, containing the URL or path to the image, and an optional title attribute enclosed in double or single quotes.
 
Reference-style image syntax looks like this:

Alt text

javascript: Copy To Clipboard
<br />Where “id” is the name of a defined image reference. Image references are defined using syntax identical to link references:
javascript: Copy To Clipboard
<br />As of this writing, Markdown has no syntax for specifying the dimensions of an image; if this is important to you, you can simply use regular HTML `&lt;img&gt;` tags.
 
## Table of Contents
 
This is not standard markup for Markdown, but it has been made available for the use of this wiki.

Table of Contents [hide]

javascript: Copy To Clipboard
<br />This will show a Table of Contents much like the one you see on this page.
 
## Escaping Markdown Markup
 
Markdown allows you to use backslash escapes to generate literal characters which would otherwise have special meaning in Markdown’s formatting syntax. For example, if you wanted to surround a word with literal asterisks (instead of an HTML `&lt;em&gt;` tag), you can use backslashes before the asterisks, like this:

*literal asterisks*

javascript: Copy To Clipboard
<br />Markdown provides backslash escapes for the following characters:

\ backslash ` backtick * asterisk _ underscore {} curly braces [] square brackets () parentheses

hash mark

  • plus sign
  • minus sign (hyphen) . dot ! exclamation mark ~~~

  1. And that's the footnote.   That's the second paragraph.