MultiMarkdown Syntax Guide
Headings
To create a heading, add one to six # symbols before your heading text. The number of # you use will determine the
hierarchy level and typeface size of the heading.
ATX-Style Headings
# This is a heading H1
## This is a heading H2
### This is a heading H3
#### This is a heading H4
##### This is a heading H5
###### This is a heading H6
# Heading with custom id [custom-id]
Setext Headings are also supported:
A First Level Header
=========
A Second Level Header
---------
Text Styling
Strong style
This text is **bold**.
This text is also __bold__.
Emphasis style
This text is *italicized*.
This text is also _italicized_.
Oblique style
This text is ***oblique***.
This text is also ___oblique___.
Strikethrough style
And this is the ~~strikethrough~~ style.
Lists
You can make an unordered list by preceding one or more lines of text with -, *, or +.
* Bulleted list item
+ Bulleted list item
- Bulleted list item
To order your list, precede each line with a number.
1. Numbered list item
2. Numbered list item
3. Numbered list item
To create a task list, preface list items with a hyphen and space followed by [ ]. To mark a task as complete, use [x].
- [ ] Task list item
- [ ] Task list item
- [x] Task list item
Nested Lists
You can create a nested list by indenting one or more list items below another item.
1. First list item
- First nested list item
- Second nested list item
Links
[Link Title](/url/to/destination)
[iwriter](https://serpensoft.com/iwriter-2/)
If your URL contains blank spaces, you must escape them by replacing them with %20.
[Optional Link Title](/url%20with%20spaces)
Inline links:
<foo@example.com>
Link to <http://serpensoft.com>
Reference-style link:
Link to [Website][Link].
...
[Link]: http://serpensoft.com
Reference link with styling:
Link to [Website].
...
[Website]: http://serpensoft.com style="border: solid black 1px;"
Images
You can display an image by adding ! and wrapping the alt text in [ ]. Alt text is a short text equivalent of the information in the image. Then, wrap the link for the image in parentheses ().
Inline image:
Image with attributes:
![image]
...
[image]: Website.png "This is a title" height=25px width=50px
Image by itself becomes a figure:
![This is the caption][image]
[image]: Website.png "This is the title" height=45px width=120px
Block-quotes
You can quote text with a >.
Regular text.
> Blockquote
> with two lines.
And one more line.
>> And a second level blockquote.
Paragraphs and Line Breaks
To create a line break in a Markdown file, you will need to include one of the following:
Include two spaces at the end of the first line.
This example
Will span two lines.
Include a backslash at the end of the first line.
This example\
Will span two lines.
Include an HTML single line break tag at the end of the first line.
This example<br/>
Will span two lines.
Or, leave a blank line between two lines.
This example
Will span two lines.
Code Blocks
This is an inline code block.
Indent text with tabs or 4+ space characters to create a multiline code block:
This is a longer
section of code
on multiple lines.
Fenced Code Blocks
```
This is a fenced
code block.
```
Fenced code block with a language marker:
```perl
print "Hello, world!\n";
$a = 0;
while ($a < 10) {
print "$a...\n";
$a++;
}
```
Footnotes
Reference style:
Text[^foot].
[^foot]: This is a footnote.
Inline:
Text[^This is an inline footnote.].
Horizontal rule
-----
- - - - -
*****
* * * * *
Tables
Simple table:
| foo | bar |
| --- | --- |
| foo | bar |
| foo bar ||
[*caption*][id]
Table with aligned columns:
| right aligned | centered | left aligned |
| ---: | :---: | :--- |
| foo | bar | bat |
| foo | bar | bat |
[*caption*][id]
HTML Blocks
The app supports plain HTML blocks.
<p>This is HTML paragraph.</p>
<mark>This text is highlighted.</mark>
You can also modify the underlying styling using CSS:
<style>
p { color: yellow; }
</style>
Please note: blank lines within tags are not supported.
Page Break
Use this code snippet to insert a page break:
<div style='break-after:page'></div>
Math and Diagrams
You can add math expressions to your notes using MathJax and the LaTeX notation.
Inline math:
$e^{2i\pi} = 1$
Math block:
$$
\begin{vmatrix}a & b\\
c & d
\end{vmatrix}=ad-bc
$$
You can add diagrams and charts to your notes, using Mermaid. Mermaid supports a range of diagrams, such as flow charts, sequence diagrams, and timelines.
```mermaid
sequenceDiagram
Alice->>+John: Hello John, how are you?
Alice->>+John: John, can you hear me?
John-->>-Alice: Hi Alice, I can hear you!
John-->>-Alice: I feel great!
```
Table of contents
Use this shortcut to generate the document’s table of contents:
{{TOC}}
The table of contents will be automatically generated from the available headings.
Insert other documents (transclusion)
Use the following syntax to attach the content of external document:
{{filename.md}}
{{folder/filename.md}}
{{folder/filename with spaces.md}}
Citations
Reference style:
Cite a source.[p. 42][#source]
[#source]: John Doe. *A Totally Fake Book*. Vanity Press, 2006.
Inline:
Cite a source.[p. 42][#John Doe. *A Totally Fake Book*. Vanity Press, 2006.]
Cross-references
# Intro #
# Conclusion [fin] #
Link to [Intro].
Link to the [end][fin].
Definition Lists
Apple
: Pomaceous fruit of plants of the genus Malus
in the family Rosaceae.
Also the makers of really great products.
Abbreviations
Reference style:
HTML and HTML
[>HTML]: Hypertext Markup Language
Inline:
[>(HTML) Hypertext Markup Language] and HTML
Glossary
Reference style:
[?Glossary] is a glossary term.
[?Glossary]: The glossary collects information about
important terms used in your document.
Inline:
[?(Glossary) The glossary collects information about important terms used in your document] is a glossary term.
Subscript & Superscript
m2
m^2
x2y3
x^2 y^3
xz
x~z
C6H12O6
C~6~H~12~O~6~
Escaped characters
\& \$ \* \_
Document Metadata
Metadata fields should be added at the top of the document.
Title: This is a title
Author: John Appleseed
E-Mail: email@server.com
Date: 2025-10-20
Metadata will be applied during the export process.
Acknowledgements
MultiMarkdown Syntax Guide by Fletcher T. Penney.