Here is a description of the emacs-wiki markup rules, it has been taken from http://www.gci-net.com/users/j/johnw/WikiMarkup.html.
* First level
** Second level
*** Third level
Note that the first level is actually indicated using H2, so that it doesn't appear at the same level as the page heading (which conceptually titles the section of that Wiki page).
One or more blank lines separates paragraphs.
See if the <BR>
parameter has an effect.
Yeah! It does.
Four or more dashes designed a horizontal rule. Be sure to put blank lines around it, or it will be considered part of the proceeding or following paragraph!
----
Formatting | Markup |
---|---|
emphasis: | *emphasis* (without space between '* ' and emphasized words) |
strong emphasis: | **strong emphasis** |
very strong emphasis: | ***very strong emphasis*** |
underlined: | _underlined_ |
and monospace | =monospace= --- result of equal signs is the <code></code>-tag. |
... | one could also enter the <code></code> -tags directly, but why? |
No conversion of | <verbatim> *strong* _underlined_ =code= </verbatim> They just prevent equal-signs and asterisks etc. from being interpreted as EmacsWikiMarkup-symbols, no tags appear in the html-document. |
A reference1, which is just a number in square brackets [1]
,
constitutes a footnote reference.
[1] Footnotes are defined by the same number in brackets occurring at the beginning of a line. Use footnote-mode's C-c ! a command, to very easily insert footnotes while typing. Use C-x C-x to return to the point of insertion. Paragraphs
A line that begins with six or more columns of whitespace (made up of tabs or spaces) indicates a centered paragraph. I assume this because it's expected you will use M-s to center the line, which usually adds a lot of whitespace before it.
If a line begins with some whitespace, but less than six columns, it indicates a quoted paragraph.
It translates to the <blockquote>-html-tag.
Poetry requires that whitespace be preserved, without resorting to the monospace typical of pre. For this, the following special markup exists, which is reminiscent of e-mail quotations:
> A line of Emacs verse; > forgive its being so terse.
results in the html-tag <p class="verse">
:
A line of Emacs verse; forgive its being so terse.
You can also use the verse tag, if you prefer:
<verse> A line of Emacs verse; forgive its being so terse. </verse>
results in a tag <verse>
that is obviously also not recognized
by browsers on their on (formatting then depends on the css
file/section):
Use the HTML tags <pre></pre>
to insert a paragraph and
preserve whitespace. If you're inserting a block of code, you will
almost always want to use <verbatim></verbatim>
within
the pre tags. The shorcut for doing this is to use the
<example>
tag:
<example> Some literal text or code here. </example>
(the <example>
tag results in html-tag <pre
class="example">
, so you can use pre.example
in
the css-header to change it's appearance)
- bullet list
1. Enumerated list
Term :: Definition
There must be a blank line between list elements. Trying to support ganged-up list items was needlessly complicated.
Only very simple table markup is supported. The attributes of the table are kept in `emacs-wiki-table-attributes'. The syntax is:
Double bars || Separate header fields Single bars | Separate body fields Here are more | body fields Triple bars ||| Separate footer fields
and the result is:
Double bars | Separate header fields |
---|---|
Single bars | Separate body fields |
Here are more | body fields |
Triple bars | Separate footer fields |
Other paragraph markup applies, meaning that if six or more columns of whitespace precedes the first line of the table, it will be centered, and if any whitespace at all precedes first line, it will occur in a blockquote.
If you begin a line with #anchor
-- where anchor can be any
word that doesn't contain whitespace -- it defines an anchor at that
point into the document. This anchor text is not displayed.
You can reference an anchored point in another page (or even in the
current page) using EmacsWikiMarkup#anchor
. The #anchor will never
be displayed in HTML, whether at the point of definition or reference,
but it will cause browsers to jump to that point in the document:
EmacsWikiMarkup.
Sometimes you may wish to redirect someone to another page. To do this, put:
redirect url="http://somewhereelse.com"/
at the top of the page. If the redirect tag specifies content, this will be used as the redirection message, rather than the default. The redirect URL can also be a Wiki page name.
The numbers of seconds to delay is defined by `emacs-wiki-redirect-delay', which defaults to 2 seconds. The page shown will also contain a link to click on, for browsing which do not support automatic refreshing.
A regular URL is given as a link. If it's an image URL, it will be inlined using an IMG tag.
<lisp>(concat "This form gets" "inserted")</lisp>
If you need to add a plural at the end of a WikiName, separate it with
four single quotes: WikiName''''s
→ WikiNames.
To prevent a link name (of any type) from being treated as such, surround it with = = (to display it in monotype), or prefix it with the tag nop.
Besides the normal WikiName type links, emacs-wiki also supports extended links:
[[link text][optional link description]]
An extended link is always a link, no matter how it looks. This means you can use any file in your `emacs-wiki-directories' as a Wiki file. If you provide an optional description, that's what will be shown instead of the link text. This is very useful for providing textual description of URLs.
There are times when you will want to constantly reference pages on another website. Rather than repeating the URL ad nauseum, you can define an InterWiki name. This is a set of WikiNames to URL correlations, that support textual substitution using #anchor names (which are appended to the URL). For example, MeatballWiki is defined in the variable `emacs-wiki-interwiki-names'. It means you can reference the page "MeatBall" on MeatballWiki using this syntax:
In the resulting HTML, the link is simply shown as MeatballWiki:MeatBall.