Markdown Basics: Formatting Notes Using Only Plain Text
A short introduction to Markdown, a simple way to add headings, lists and emphasis to plain-text notes, with examples you can type on any text editor.
Plain text is fast and reliable, but sometimes you'd like a heading or a bullet list. Markdown lets you add structure using ordinary characters, so your notes stay plain text.
The basics
| You type | It means |
|---|---|
| # Heading | a large heading |
| ## Subheading | a smaller heading |
| bold: two asterisks around text | bold text |
| italic: one asterisk around text | italic text |
| - item | a bullet point |
| 1. item | a numbered item |
| text | a hyperlink |
| > quote | a quotation |
The symbols are readable even when not formatted, so the note still looks tidy in a plain-text editor.
An example note
# Shopping list
- Milk
- Bread
- **Eggs** (important!)
## Later
1. Call the plumber
2. Pay the bill
In a viewer that understands Markdown, this appears with a heading, bullets and bold text. In a plain editor, it still reads well.
Why use Markdown?
- It's portable. The file is plain text, so any editor can open it.
- It's fast. No menus: you just type.
- It's future-proof. Plain text doesn't depend on any one app.
- It converts easily to web pages, documents or slides with other tools.
Where it's used
Markdown files usually end in .md. Many developers use it for README files, and many writers use it for notes and articles.
Tips for beginners
- Leave a blank line between paragraphs.
- Put a space after # and -.
- Keep it simple. Headings and lists cover most needs.
- Don't worry about the preview. The value is in the structure.
In a text editor
A lightweight editor is enough. You can write and save a file with the .md extension, and open it later in any editor.
Notepad+ Text Editor
A fast, advanced text editor for notes and code, with emoji support
More about Notepad+ Text Editor
Bullets or Sentences? Writing Notes You Can Still Understand Next Year
How to write notes that stay clear over time, and when short bullets work better than full sentences.
Read article →Drafting a Blog Post from a Plain-Text Outline
A simple process for planning and writing a post or article in a text editor, from idea to a clean first draft.
Read article →Find and Replace: Tidying Notes and Files in Seconds
How find and replace works, the options to look for and the precautions that stop it from changing more than you intended.
Read article →Text Templates: Reusable Notes You Never Retype
How to create a small set of template files for repeating tasks such as meetings, trips, weekly reviews and reports.
Read article →