Markdown Reference and Test Page
Markdown is a simple and universal syntax for text formatting. More and more writers switch to markdown, because they can format their text during the writing process without using any format-buttons. Once they are familiar with the markdown syntax, they can write formatted text much easier and faster than with any standard HTML-editor.
Developers love markdown, because it is much cleaner and saver than HTML. And they can easily convert markdown to a lot of other document formats like HTML and others.
If you develop a theme for TYPEMILL, please take care that all elements on this page are designed properly.
Table of Contents
To create a table of contents, simply write [TOC]
in a separate line. It will be replaced with a table of contents like this automatically.
- Markdown Reference and Test Page
Headlines
Headlines are simply done with hash chars like this:
# First Level Headline
## Second Level Headline
### Third Level Headline
#### Fourth Level Headline
##### Fifth Level Headline
###### Sixth Level Headline
Third Level Headline
A third headline is more decent and lower prioritized than a second level headline.
Fourth Level Headline
A fourth level headline is more decent and lower prioritized than a third level headline.
Fifth Level Headline
A fifth level headline is more decent and lower prioritized than a fourth level headline.
Sixth Level Headline
A sixth level headline is more decent and lower prioritized than a fifths level headline.
Paragraph
A paragraph is a simple text-block separated with a new line above and below.
A paragraph is a simple text-block separated with a new line above and below.
Soft Linebreak
For a soft linebreak (eg. for dialoges in literature), add two spaces at the end of a line and use a simple return.
She said: "Hello"
He said: "again"
For a soft linebreak (eg. for dialoges in literature), add two spaces at the end of a line and use a simple return.
She said: "Hello"
He said: "again"
Emphasis
For italic text use one *asterix* or one _underscore_.
For bold text use two **asterix** or two __underscores__.
For italic text use one asterix or one underscore.
For bold text use two asterix or two underscores.
Lists
For an unordered list use a dash
- like
- this
- nested
- list
Or use one asterix
* like
* this
For an ordered list use whatever number you want and add a dot:
1. like
1. this
For an unordered list use a dash
- like
- this
- nested
- list
Or use one asterix
- like
- this
For an ordered list use whatever number you want and add a dot:
- like
- this
Horizontal Rule
Easily created for example with three dashes like this:
---
Easily created for example with three dashes like this:
Links
This is an ordinary [Link](http://typemill.net).
Links can also be [relative](/info).
You can also add a [title](http://typemill.net "typemill").
You can even add [ids or classes](http://typemill.net){#myid .myclass}.
Or you can use a shortcut like http://typemill.net.
This is an ordinary Link.
Links can also be relative.
You can also add a title.
You can even add ids or classes.
Or you can use a shortcut like http://typemill.net.
Images
The same rules as with links, but with a !
![alt-text](media/markdown.png)
*With caption*
![alt-text](media/markdown.png "my title"){#myid .imgClass}
*With caption that spans over several lines*
![alt-text](media/markdown.png "my title"){#myid .otherclass width=150px}
The same rules as with links, but with a !
Linked Images
You can link an image with a nested syntax like this:
[![alt-text](media/markdown.png)](https://typemill.net)
You can link an image with a nested syntax like this:
Image Position
You can controll the image position with the classes .left, .right and .middle like this:
![alt-text](media/markdown.png){.left}
*With caption that spans over several lines*
![alt-text](media/markdown.png){.right}
*With caption that spans over several lines*
![alt-text](media/markdown.png){.center}
*With caption that spans over several lines*
The first image should float on the left side of this paragraph. This might not work with all themes. If you are a theme developer, please ensure that you support the image classes "left", "right" and "center". You can add these classes manually in the raw mode or you can assign them in the visual mode when you edit a picture (double click on it to open the dialog). Images in a separate line are rendered with the html5 elements figure
and figcapture
.
The second image should float on the right side of this paragraph. This might not work with all themes. If you are a theme developer, please ensure that you support the image classes "left", "right" and "center". You can add these classes manually in the raw mode or you can assign them in the visual mode when you edit a picture (double click on it to open the dialog). Images in a separate line are rendered with the html5 elements figure
and figcapture
.
The thirds image should be placed above this paragraph and centered to the middle of the content area. This might not work with all themes. If you are a theme developer, please ensure that you support the image classes "left", "right" and "center". You can add these classes manually in the raw mode or you can assign them in the visual mode when you edit a picture (double click on it to open the dialog). Images in a separate line are rendered with the html5 elements figure
and figcapture
.
Blockquote
There are always some women and men with wise words
> But I usually don't read them, to be honest.
There always some women and men with wise words
But I usually don't read them, to be honest.
Footnotes
You can write footnotes[^1] with markdown.
Scroll down to the end of the page[^2] and look for the footnotes.
Add the footnote text at the bottom of the page like this:
[^1]: Thank you for scrolling.
[^2]: This is the end of the page.
You can write footnotes1 with markdown.
Scroll down to the end of the page2 and look for the footnotes.
Footnotes won't work with the visual editor right now, so please use the raw mode for them.
Abbreviations
*[HTML]: Hyper Text Markup Language
*[W3C]: World Wide Web Consortium
You won't see the abbreviation directly, but if you write HTML or W3C somewhere, then you can see the tooltip with the explanation.
Definition List
Apple
: Pomaceous fruit of plants of the genus Malus in the family Rosaceae.
Orange
: The fruit of an evergreen tree of the genus Citrus.
- Apple
- Pomaceous fruit of plants of the genus Malus in the family Rosaceae.
- Orange
- The fruit of an evergreen tree of the genus Citrus.
Notices
You can create different notices if you add a '!', '!!', '!!!', '!!!!' before a line. This will wrap the content into a div-class with the classes notice1
, notice2
, notice3
and notice4
. You can also span notices over several lines. This logic follows some other CMS like Grav, Lektor or Yellow and it is not compatible with other markdown processors or editors.
Notice 1
Please note that you can use markdown inside of the notice so you can format your text here.
Notice 2
Please note that you can use markdown inside of the notice so you can format your text here.
Notice 3
Please note that you can use markdown inside of the notice so you can format your text here.
Tables
|name |usage |
|-----------|-----------|
| My Name | For Me |
| Your Name | For You |
Name | Usage |
---|---|
My Name | For Me |
Your Name | For You |
Code
Let us create some `<?php inlineCode(); ?>` like this
Let us create some <?php inlineCode(); ?>
and now let us check, if a codeblock works:
Use four apostroph like this:
\````
<?php
$welcome = 'Hello World!';
echo $welcome;
?>
\````
Strikethrough
You can use two tilde signs to create a ~~strikethrough~~ text
You can use two tilde signs to create a strikethrough text
Escape Characters
You can escaped all characters with a backslash: \*emphasis\*.
You can escaped all characters with a backslash: *emphasis*.
Special Characters
Typemill does not allow any html tags like <sup>
, but⁰ you¹ can² still³ copy and pasteⁿ charactersₓ from unicodeⁿ tables͓ if̥ you @ need ® some special characters.
Math
Please activate the math-plugin to use mathematical expressions with LaTeX syntax. You can choose between MathJax or the newer KaTeX library. MathJax is included from a CDN, KaTeX is included in the plugin. So if you don't want to fetch code from a CDN, use KaTeX instead. The markdown syntax in TYPEMILL is the same for both libraries.
Write inline math with \(...\) or $...$ syntax.
inline $x = \int_{0^1}^1(-b \pm \sqrt{b^2-4ac})/(2a)$ math
inline \(x = \int_{0^1}^1(-b \pm \sqrt{b^2-4ac})/(2a)\) math
inline \(x = \int_{0^1}^1(-b \pm \sqrt{b^2-4ac})/(2a)\) math
inline \(x = \int_{0^1}^1(-b \pm \sqrt{b^2-4ac})/(2a)\) math
Write display math with $$...$$ or \[...\] syntax.
$$
x = \int_{0^1}^1(-b \pm \sqrt{b^2-4ac})/(2a)
$$
\[
x = \int_{0^1}^1(-b \pm \sqrt{b^2-4ac})/(2a)
\]