Markdown Guide

A quick reference for Markdown syntax in PlainApp notes — headings, lists, tables, code blocks, and more.

Headings

Add # at the start of a line — the number of # sets the level, from 1 (largest) to 6 (smallest). Keep a blank line before and after a heading.

Markdown
# Heading level 1
## Heading level 2
### Heading level 3
#### Heading level 4
##### Heading level 5
###### Heading level 6
Result

Heading level 1

Heading level 2

Heading level 3

Heading level 4

Heading level 5
Heading level 6

Tip: The Heading button on the PlainApp editor toolbar inserts these for you.

Paragraphs & Line Breaks

Separate paragraphs with a blank line. To break a line within a paragraph, end the line with a backslash.

Markdown
First paragraph.

Second paragraph.
Result

First paragraph.

Second paragraph.

Markdown
Line one\
Line two
Result

Line one
Line two

Bold & Italic

Wrap text in double asterisks for bold or single asterisks for italic. Two tildes render strikethrough.

Markdown
**bold text**
Result

bold text

Markdown
*italic text*
Result

italic text

Markdown
~~struck through~~
Result

struck through

Markdown
**bold and *nested italic***
Result

bold and nested italic

Lists

Start a line with - for a bullet or 1. for a numbered item. Indent with spaces to nest items. Use - [ ] for a checklist and - [x] when done.

Markdown
- One
- Two
- Three
Result
  • One
  • Two
  • Three
Markdown
1. First
2. Second
3. Third
Result
  1. First
  2. Second
  3. Third
Markdown
- [ ] Buy milk
- [x] Write the note
Result
  • Buy milk
  • Write the note
Markdown
- Fruit
  - Apple
  - Banana
- Vegetable
Result
  • Fruit
    • Apple
    • Banana
  • Vegetable

Blockquotes & Callouts

Start a line with > to quote. In PlainApp, > [!note] turns the block into a callout box.

Markdown
> This is a blockquote.
Result

This is a blockquote.

Markdown
> [!note] Heads up
> This renders as a callout box in PlainApp.
Result

[!note] Heads up This renders as a callout box in PlainApp.

Code

Wrap inline code in single backticks. Use triple backticks for a code block, and add a language name after them for syntax highlighting.

Markdown
Use `inline code` for short snippets.
Result

Use inline code for short snippets.

Markdown
```js
console.log("hello");
```
Result
console.log("hello");

Tip: The Code button on the editor toolbar inserts inline code and code blocks.

Images

Same as a link with an exclamation mark in front: ![alt text](image URL).

Markdown
![PlainApp logo](/plainapp.svg)
Result

PlainApp logo

Tables

Build a table with pipes

Markdown
| Left | Center | Right |
|:-----|:------:|------:|
| a    | b      | c     |
| d    | e      | f     |
Result
Left Center Right
a b c
d e f

Tip: The Table button on the editor toolbar inserts an empty table skeleton.

Horizontal Rules

Three or more dashes, asterisks, or underscores on their own line create a divider. Leave a blank line above it, or the previous line turns into a heading.

Markdown
First section.

---

Second section.
Result

First section.


Second section.

Escaping Characters

Prefix a backslash to show characters that Markdown would otherwise format, like * _ # or backtick.

Markdown
\*not italic\*
Result

*not italic*

Markdown
\# not a heading
Result

# not a heading

Inline HTML

PlainApp also renders a few HTML tags in notes: underline, highlight, colored text, and collapsible details.

Markdown
<u>underlined text</u>
Result

underlined text

Markdown
<mark>highlighted text</mark>
Result

highlighted text

Markdown
<font color="#8b5cf6">colored text</font>
Result

colored text

Markdown
<details>
<summary>Click to expand</summary>
Hidden content here.
</details>
Result
Click to expand Hidden content here.

Math & More

Superscript x^2^, subscript H~2~O, inline math $E = mc^2$, math blocks with $$, footnotes [^1], and %% comments %% that stay hidden in the rendered note.

Markdown
x^2^ + y^3^
Result

x^2^ + y^3^

Markdown
H~2~O
Result

H2O

Markdown
Inline math $E = mc^2$ and a block:
$$
a^2 + b^2 = c^2
$$
Result

Inline math $E = mc^2$ and a block: $$ a^2 + b^2 = c^2 $$

Markdown
See the footnote[^1] for details.

[^1]: This is the footnote text.
Result

See the footnote[^1] for details.

[^1]: This is the footnote text.

Markdown
%% This comment stays hidden in PlainApp %%
Result

%% This comment stays hidden in PlainApp %%

Tip: Math, footnotes and callouts render as rich blocks in PlainApp notes; the Result column here shows plain web output.