Markdown for Notes: The Complete Beginner’s Guide

Markdown is a way of writing plain text so that simple characters — like #, *, and - — indicate formatting, without ever touching a mouse or a toolbar. It was created by John Gruber in 2004, and the original specification is still the clearest reference: see Daring Fireball's Markdown syntax page. This guide covers the core syntax, the GitHub-Flavored extensions that most apps add on top, and how Markdown fits into Luma.

Want the short version to keep on your desk? Grab the free Markdown cheat sheet and come back to this guide whenever you need the detail behind a symbol.

What Markdown actually is

Markdown is a lightweight markup language: you type plain text with a handful of extra characters, and a Markdown processor converts it into formatted output (usually HTML). The core idea from the original spec is that a Markdown document should be readable as plain text even before it's converted — the syntax should look like what it means, not like code.

That's why **bold** is bold-ish just by looking at it, and why a line starting with - reads like a bullet even in a plain text file.

Headings

A # at the start of a line makes a heading. More # characters make a smaller heading:

# Heading 1
## Heading 2
### Heading 3

Use one # for a document title and ##/### for sections and subsections — don't skip levels, since some renderers (and outline tools) rely on the order.

Emphasis

*italic* or _italic_
**bold** or __bold__
***bold and italic***

Lists

Unordered lists use -, *, or + at the start of a line; ordered lists use numbers followed by a period:

- First item
- Second item
  - Nested item (indent two spaces)

1. First step
2. Second step

Links

[link text](https://example.com)

Every link in this guide is written that way — for instance, our Cornell notes template or the digital note-taking guide both use [text](url).

Blockquotes

A > at the start of a line makes a blockquote, which is useful for setting off a quotation or a note from the surrounding text:

> This is a blockquote. It can span
> multiple lines if each one starts with >.

Inline code

Wrap a short piece of code or a literal value in single backticks: `like this`. It's the right choice for a filename, a variable, or a command inside a sentence.

Fenced code blocks

For a whole block of code, use three backticks on their own line before and after the code, optionally with a language name for syntax highlighting:

```python
def greet(name):
    print(f"Hello, {name}")
```

Notice that example itself is wrapped in four backticks on the outside — that's the trick for showing a fenced code block inside another block of Markdown without the two fences colliding.

GitHub-Flavored Markdown (GFM): tables and task lists

Tables and task lists are not part of the original Markdown syntax — they were added later by GitHub as part of what's now called GitHub-Flavored Markdown (GFM), and most modern note apps and renderers (Luma included) support the GFM extensions on top of the original spec. Worth knowing so you're not surprised if a strict, original-spec Markdown tool doesn't render them.

Tables:

| Column A | Column B |
|----------|----------|
| Row 1    | Value    |
| Row 2    | Value    |

Task lists:

- [ ] Not done yet
- [x] Done

How Markdown fits into Luma

Luma is a rich-text editor, not a plain-text Markdown editor: you type and format notes visually (bold, headings, lists, and so on), and Luma can export a note to Markdown when you want a plain-text copy — for example to paste into GitHub, drop into an AI chat, or move a note into a different app. Luma does not store your notes as local .md files on disk; your notes live in your Luma account, and Markdown export is a way to get a portable copy out when you need one.

If you specifically want to write in raw Markdown syntax with a live preview and manage your own .md files, dedicated Markdown editors are a better fit for that particular workflow. Luma's strength is a fast, richly formatted note that you can still export as clean Markdown when portability matters.

Putting it into practice: from lecture notes to study material

A simple workflow that uses everything above: take lecture notes with headings for each topic and a bullet list for key points, use a blockquote for anything the instructor said should be memorized verbatim, and mark unclear points with a task list item like - [ ] ask about this. Afterward, turn the structured note into a Cornell notes layout, and when it's time to review, run it through Notes to Flashcards to generate a study deck.

Common mistakes

1. No blank line around a heading or code block. Many renderers need a blank line before and after these elements to parse them correctly.
2. Inconsistent list indentation. Use two spaces for a nested bullet, not one — inconsistent indentation is the most common reason a nested list renders flat.
3. Forgetting the language name on a fenced code block. Adding it (like ```python) enables syntax highlighting; leaving it off still works, but loses the highlighting.
4. Assuming every renderer supports GFM. Tables and task lists are extensions — a strict original-Markdown parser will show the raw | and - [ ] characters instead of a formatted table or checkbox.

Frequently asked questions

Do I need to memorize all of this? No — headings, bold/italic, lists, and links cover the vast majority of everyday writing. Keep the cheat sheet nearby for the rest.

Is Markdown the same as GitHub-Flavored Markdown? No. Markdown is the original 2004 syntax described at Daring Fireball. GFM is GitHub's extended version that adds tables, task lists, strikethrough, and a few other conveniences, and it's what most modern apps actually support.

Can I write raw Markdown inside Luma? Luma is built around rich-text formatting rather than raw Markdown syntax, but it can export your note as Markdown when you need a plain-text copy.

Does Luma keep local .md files on my computer? No — Luma stores your notes in your account, not as local files on disk. Markdown export gives you a portable text copy whenever you want one.

Next steps

Start with the free Markdown cheat sheet, practice on your next set of lecture notes, and see our digital note-taking guide for how Markdown fits into a broader note system.