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*
Strikethrough ~~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 x inside 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.