Markdown
A simple, lightweight text-based language for formatting documents.
PageSeeder supports Markdown in both comments and document properties.
In the following examples, a full stop character '.'
is used to represent the space character.
Block formatting
Style | Pattern | Description |
---|---|---|
Title |
| Title is formatted as heading1 when a paragraph is followed by a line of '=' characters. |
Subtitle |
| Subtitle is formatted as heading2 when a paragraph is followed by a line of '-' characters. |
Heading |
| To express a hierarchical collection of headings, prefix single line paragraphs with between one '#' to six '######' characters. |
Unordered list (bullet list) |
| Unordered list items are preceded by a single '*', '-' or '+'. All paragraphs that follow the list item are treated as additional items until the occurrence of a blank line terminates the list. Nested (multi-level) lists are not supported. |
Ordered list (Numbered list) |
after processing, this becomes:
or: <nlist start="3"> <item>Red</item> <item>Blue</item> <item>Aqua</item> </nlist> |
Ordered list items are initiated by a new paragraph that begins with a digit and a full stop '.' character. Each subsequent paragraph becomes a new list item, until a blank line terminates the list. Nested (multi-level) lists are not supported. Only the number in front of the first paragraph is processed. It sets the starting number and all others are ignored. To prevent a line from being treated as a list item, prefix the full stop character with a backslash 3\. Red 21\. Blue Aqua |
Preformatted |
....function () { ......// do something! ....} | When at least four spaces precede the start of a line, indentation is preserved but no further formatting is available. |
Preformatted block |
``` function () { // do something! } ``` | This string ``` on an empty line, treats all subsequent lines as preformatted until the same string terminates that style. |
Blockquote |
| Any line preceded by at least one '>'. No other formatting within quoted content. |
Paragraph |
| Paragraphs are blocks of text separated by at least one empty line. |
Line breaks |
| Any line of less than 66 characters long inserts a line break inside a paragraph. Multiple empty lines also add line breaks outside paragraphs. |
Inline formatting
Inline formatting only applies to paragraphs, headings and lists.
Style | Pattern | Description |
---|---|---|
Bold | An **important** note | Any inline text surrounded by double '*' appears in bold. |
Italic | An *important* note | Any inline text surrounded by single '*' appears in italics. |
Code | `a+b=c` | Any inline text surrounded by single left quotes '`' is interpreted as code and displayed using a monospace font. |
Autolink | At http://example.org! | Any text starting with http:// or https:// is automatically turned into link. The link is displayed verbatim but must end with a letter or number. |
Explicit link | <mailto:support@example.org> <http://www.example.org> | To explicitly create a link that might include characters to be escaped or for email addresses. Must start with http:// , https:// or mailto: . The protocol is not displayed in the document. |
Titled link | [PageSeeder](http://ps.com) | To display a different title, wrap the title in square brackets immediately before the address in round brackets. |