Markdown Basics
2026-11-15
Markdown marks up formatting with symbols: two asterisks for bold, a hash for a heading. You keep writing; the symbols carry the format, and the software handles the layout.
The app is WYSIWYG by default: symbols turn into formatted output as you type; source mode shows and edits the raw markup.
Why Markdown
- Every format without leaving the keyboard — no train of thought broken;
- Plain text, opens in any editor;
- Small files, easy to back up and sync.
Headings and paragraphs
A blank line starts a new paragraph. A hash plus a space at line start makes a heading; the number of hashes is the level (# through ######, six levels) — levels two and three see most of the action.
Emphasis
| Effect | Markup |
|---|---|
| Bold | **text** |
| Italic | *text* |
~~text~~ |
|
Inline code |
wrap the text in backticks |
Lists and quotes
- Unordered list: dash + space at line start; indent one level per nesting;
- Ordered list: number + dot + space;
- Task list: dash, space, brackets (an
xinside marks it done); - Quote: greater-than + space, for excerpts.
Links and images
- Link:
[text](url), e.g.[BigLazyCat](https://example.com); - Image: a link with an exclamation mark in front — or just paste / drag an image file in.
Rules and code blocks
Three dashes alone on a line make a horizontal rule. Three backticks alone on a line open a code block, and three close it; append a language name (js, python…) after the opening backticks for syntax highlighting.
Tables, formulas, task lists and more are covered in Advanced Markdown.