Markdown is formatted plain text

In this lesson you will learn what Markdown is, what a Markdown document looks like before and after rendering, and where the format is commonly useful.

Markdown is plain text plus a small set of readable conventions. Asterisks mark emphasis, hashes mark headings, dashes mark list items. Nothing is hidden: the source file is the document, and any text editor can open it. A renderer — a preview pane, a site generator, a notes app — turns those conventions into structured output when you want to read the formatted result.

Syntax and rendered output

A short note, as typed:

# Shopping list

Buy **oat milk** and *bread*.

- [ ] Oat milk
- [ ] Bread

Rendered, that is a top-level heading, a paragraph with bold and italic words, and a two-item checklist. The source never stops being plain text: copy it into any editor and it still reads fine.

Why portability matters

Because the format is just text, Markdown notes move freely. Export a note as .md from Typehall and it opens in editors, wikis, static-site generators, and chat tools that accept Markdown. No converter owns your words — the file is the whole story, which is also why Markdown is a natural fit for a local-first notepad: the text you autosave in your browser is already in a portable format.

Where Markdown shows up

• Notes and docs: READMEs, wikis, personal knowledge bases.
• Writing with structure: meeting notes, plans, checklists.
• Technical writing: code samples, tables, diagrams, equations.
• Draft review: AI assistants commonly emit Markdown you can paste anywhere.

One honest limit up front: Markdown has dialects. Core syntax — headings, emphasis, lists, links, quotes, code — is universal; tables, task lists, and extensions like diagrams vary by renderer. This course teaches the Typehall dialect exactly as its preview renders it, and flags the spots where other tools differ.

# My first Markdown note

This is a paragraph with **bold** and *italic* words.

- First item
- Second item

Continue with Headings to give the document structure.