Markdown for People Who Don't Code

Markdown is a way to format text by typing a few plain symbols — a star for italics, two stars for bold, a hash for a heading, a dash for a list. You do not need to be a programmer. If you can type, you can write Markdown. It looks like normal text, and it stays readable on its own.

That is the whole idea, and it is older than most apps you use. John Gruber created Markdown in 2004 — with Aaron Swartz as his "sounding board" during development ¹ — and announced it on March 15, 2004 with one plain sentence: Markdown "allows web writers to compose text using a simple, readable, plain text formatting syntax" ². Web writers, not web developers. Twenty-two years later the same handful of symbols formats your Reddit comments, your Discord messages, your ChatGPT replies, and the README files behind GitHub's 100-million-plus developer community ³. You have almost certainly read Markdown already. This post teaches you to write it on purpose, using the six to eight marks that cover everything most people ever need.

What is Markdown, in plain English?

Markdown is a small set of typing conventions that turn plain text into formatted text. You type a star around a word to make it italic; the app shows it slanted. You type a hash before a line to make it a heading. The symbols are simple enough to read straight — no menus, no toolbar, no code.

The Markdown Guide puts the durability case plainly: "Markdown syntax is designed to be readable and unobtrusive, so the text in Markdown files can be read even if it isn't rendered" ⁴. That is the difference from a word processor. In Microsoft Word, the formatting hides inside the file; open it in a plain text viewer and you get garbage. In Markdown, the formatting is the text — a star is a star, visible and obvious — so the note stays legible in any editor, on any device, for as long as plain text survives. Gruber's stated design goal was "to make it as readable as possible" ².

External reference: Markdown Guide — Getting Started.

Why would a non-coder use Markdown?

A non-coder uses Markdown because it formats text faster than a mouse, keeps the writing portable across every app, and never traps the words inside one company's file. You write with your hands on the keyboard instead of reaching for a toolbar. The same note opens in any editor, and outlives whichever tool made it.

Steph Ango, the CEO of Obsidian, frames the long-term stakes in two sentences pinned by a generation of note-takers: "In the fullness of time, the files you create are more important than the tools you use to create them. Apps are ephemeral, but your files have a chance to last" ⁵. Markdown is the format that bet on that idea and won — it is now the canonical text syntax on Reddit, GitHub, and Discord, and the default output shape of ChatGPT and other assistants ⁴. Three concrete payoffs for someone who never touches code:

• Speed. Two keystrokes (**) make bold. No reaching for a button.
• Portability. A .md file opens in any text editor on any operating system, with no account.
• Permanence. Plain text has survived five decades of computing. Your notes inherit that.

External reference: Daring Fireball — Markdown.

The six marks you actually use

Six marks cover roughly everything a writer or student needs: headings, bold, italic, lists, links, and quotes. Learn these and you can write a clean document, a study sheet, or a journal entry without ever opening a formatting menu. Everything else in Markdown is a refinement of these six. Here is the entire working set in one table.

That is the core. Notice the pattern: the symbol looks like the thing it makes. A hash mark is heavy, so it makes a heading. A dash sits to the left, so it makes a bullet. A > points inward, so it makes a quotation. The syntax is designed to be guessable, which is why it took over the internet without anyone running a training course. The guessability is a direct consequence of Gruber's stated aim "to make it as readable as possible" ².

Headings

Put one or more hash marks (#) at the start of a line, followed by a space. One hash is the biggest heading; more hashes make smaller ones. Always leave a space after the hash, or the line stays plain text.

# Grocery List
## Produce
### Things I always forget

Bold and italic

Wrap a word in single stars for italic, double stars for bold. Some apps also accept underscores (_italic_, __bold__); stars are the safer default because they work everywhere.

This is *important* but this is **urgent**.

Lists

Start each line with a dash and a space for a bullet list. Start each line with a number, a period, and a space for a numbered list. The app handles the spacing and the numbering for you.

- eggs
- bread
- coffee

1. Wake up
2. Make coffee
3. Write one sentence

Links

Put the visible text in square brackets, then the web address in round brackets, with nothing between them.

Read the full reference at [the markdown cheat sheet](https://blog.mnmnote.com/posts/the-complete-markdown-cheat-sheet).

Quotes

Start a line with a > and a space to set it apart as a quotation. Use it for something someone said, a passage from a book, or a thought you want to hold at arm's length.

> The first draft of anything is garbage. — often attributed to Hemingway

Two more marks worth knowing

Two extra marks round out a non-coder's toolkit: the checkbox for to-do lists and the backtick for setting a word apart. Neither is essential, but both turn up constantly in real notes, and each is one character of effort. Together with the six core marks, they cover the formatting in almost any everyday document a writer, student, or planner produces.

Checkboxes (task lists)

A dash, a space, square brackets, a space, then your task makes a checkable box. Put an x between the brackets to mark it done. This one is an addition called GitHub Flavored Markdown, supported almost everywhere people take notes ⁶.

- [x] Draft the email
- [ ] Send the email
- [ ] Stop worrying about the email

Backticks (set a word apart)

Wrap a word in single backticks (the key above Tab) to display it in a plain, even-width style. Non-coders use it to make a literal word stand out — a filename, a button name, a search term — without bolding it.

Click the `Save` button, then look for `notes.md` in your folder.

What you can ignore for now

You can safely skip tables, footnotes, math, diagrams, and raw HTML until the day you actually need one. They exist, they are useful for documentation and academic work, and they live in the full reference. None of them is required to write a clean note, a journal entry, a study sheet, or a draft. Markdown rewards starting small.

The format grew a periphery over twenty-two years — GitHub Flavored Markdown added tables and checkboxes; tools like Obsidian added wiki-links and callouts; academic writers added footnotes and math ⁶. But the base spec barely changed. CommonMark, the formal, testable specification maintained by John MacFarlane and a small group from GitHub, Stack Overflow, and Discourse, has sat at version 0.31.2 since January 28, 2024 ⁷. The reason the syntax above will still work in 2036 is that the core has been effectively finished for years. If you ever do need the advanced marks, the exhaustive list lives in the complete markdown cheat sheet — this post is the on-ramp; that one is the manual.

Where your Markdown actually works

Your Markdown works almost everywhere you already type. The same symbols format comments on Reddit, messages in Discord, README files on GitHub, and the answers ChatGPT writes back to you. A note written in Markdown is not locked to one app — it reads the same in a dozen places, because the syntax is plain text the whole way down.

The Markdown Guide lists the reach directly: "Websites like Reddit and GitHub support Markdown, and lots of desktop and web-based applications support it" ⁴. The list of those applications is long — Obsidian, Bear, Joplin, Simplenote, WordPress, Ghost, and many browser-based editors among them ⁴. This is the quiet superpower for a non-coder: learn the syntax once, and you have learned the formatting language of most of the modern internet. The table below shows the same five marks rendering in three places you probably use weekly.

Chat apps trim the syntax down rather than drop it — Discord takes #, ##, and ### but stops there, and reads __underline__ as underline where standard Markdown reads it as bold ⁸ — while bold, italic, lists, and headings travel nearly everywhere. When a mark does not render, it simply shows as the plain symbols you typed, which is harmless and still readable. That graceful fallback is exactly what Gruber meant by "publishable as-is, as plain text" ².

A starter document you can copy

Here is a complete, real note written only in the eight marks above. Copy it into any Markdown editor, change the words, and you have a working template. Nothing in it requires a single line of code — it is just text with a few stars, hashes, and dashes doing the formatting.

# Weekly Plan

## Top priority
The **one thing** that has to happen this week.

## To do
- [ ] Call the dentist
- [x] Pay the rent
- [ ] Read one chapter of *Middlemarch*

## Notes
A useful link: [the markdown cheat sheet](https://blog.mnmnote.com/posts/the-complete-markdown-cheat-sheet).

> A quiet reminder I want to keep at the top of my week.

Search for the file `weekly-plan.md` to find this again.

Rendered, that note has a title, two sections, a bold phrase, a to-do list with one item checked (a GitHub Flavored Markdown addition) ⁶, an italic book title, a link, a quotation, and a set-apart filename — every one of the marks in this guide, in a document a non-coder can write in under a minute.

Frequently Asked Questions

These are the questions non-coders ask most often before they start: whether Markdown is really for them, how it differs from a word processor, how to bold a word, how to make a list, where it works, and whether it will last. Each answer below is short, plain, and meant to be acted on today.

Q: Do I need to know how to code to use Markdown? A: No. Markdown was built for writers, not programmers. John Gruber announced it in 2004 as a syntax that "allows web writers to compose text using a simple, readable, plain text formatting syntax" ². You format text by typing a few visible symbols — a star, a hash, a dash. No code, no command line, nothing to install.

Q: What is the difference between Markdown and a word processor like Word? A: In Word, the formatting is hidden inside the file and needs Word to display it. In Markdown, the formatting is visible plain text — a star means italic, right there on the page. The Markdown Guide notes the text "can be read even if it isn't rendered" ⁴, so your notes stay legible in any editor, forever.

Q: How do I make text bold in Markdown? A: Wrap the words in double stars: type **important** and it renders as important. For italic, use single stars: *quietly* becomes quietly. For both at once, use three stars. Most apps also accept underscores (__bold__, _italic_), but stars are the safer default because they work in every Markdown tool.

Q: How do I make a list in Markdown? A: For a bullet list, start each line with a dash and a space (- milk). For a numbered list, start each line with a number, a period, and a space (1. first). The editor handles the spacing and numbering. For a to-do list, type - [ ] task, and put an x in the brackets to mark it done ⁶.

Q: Where does Markdown actually work? A: Almost everywhere you type. The Markdown Guide states that "websites like Reddit and GitHub support Markdown, and lots of desktop and web-based applications support it" ⁴. The same symbols format Discord messages, ChatGPT replies, and notes in apps like Obsidian and Bear. Learn it once and you can format most of the modern internet.

Q: Will Markdown still work in ten years? A: Almost certainly. The core syntax has barely changed since 2004, and the formal CommonMark specification has held at version 0.31.2 since January 28, 2024 ⁷. Because a Markdown file is plain text, it survives as long as plain text does — which, after five decades of computing, is effectively forever ⁵.

Q: What is the easiest way to start writing Markdown today? A: Open any editor that understands Markdown and type one heading and one list. You do not need an account or an install to try it; any plain-text editor or browser-based Markdown editor will do. Type a #, a space, and a title, and you have written your first line of Markdown.

Markdown is the rare skill you can learn in five minutes and use for the rest of your life — a writer's tool that happens to have been adopted by programmers, not the other way around. Start with the eight marks above, and when you outgrow them, the full reference is one click away.

You do not need to be a programmer to write in a format that will still open when the programmers have moved on; you only need to type a star, and mean it.

mnmnote.com lives in your browser — markdown in, markdown out, no account, no install.