Make a note easier to scan.
Give every idea a place with a title and section headings.
Read the descriptive transcript
Follow the complete narration and the changes shown in the video. Each example can be copied.
1. Make the structure visible
Let's make this meeting note easier to scan. We'll give it a title, then separate the decision from the action.
Source shown
Garden meeting
Decisions
Keep the reading bench.
Actions
Mira will draw the layout.On screen
The cursor identifies the relevant source or preview area. Formatting changes follow the spoken instructions.
2. One document. Two views.
The left pane is the Markdown you edit. The right pane shows the same document as a reader sees it.
Source shown
Garden meeting
Decisions
Keep the reading bench.
Actions
Mira will draw the layout.On screen
The cursor identifies the relevant source or preview area. Formatting changes follow the spoken instructions.
3. 01 / Give the note a title
First, put the cursor at the start of Garden meeting, before the G. Type one hash character. Then press Space.
Source shown
# Garden meeting
Decisions
Keep the reading bench.
Actions
Mira will draw the layout.On screen
The cursor moves to the start of the first line. A hash and a space are typed, and the preview shows the line as a title.
4. The space completes the heading
Now Garden meeting is a level one heading. The hash stays in the source, but the preview shows the title without it.
Source shown
# Garden meeting
Decisions
Keep the reading bench.
Actions
Mira will draw the layout.On screen
The cursor identifies the relevant source or preview area. Formatting changes follow the spoken instructions.
5. 02 / Add a section heading
Next, put the cursor before Decisions. Type two hashes, then a space.
Source shown
# Garden meeting
## Decisions
Keep the reading bench.
Actions
Mira will draw the layout.On screen
The cursor identifies the relevant source or preview area. Formatting changes follow the spoken instructions.
6. A section gives the paragraph context
Two hashes make a level two heading: a section within the note. Keep the decision itself as an ordinary paragraph below it.
Source shown
# Garden meeting
## Decisions
Keep the reading bench.
Actions
Mira will draw the layout.On screen
The cursor identifies the relevant source or preview area. Formatting changes follow the spoken instructions.
7. 03 / Spot the missing step
Let's try Actions. This time, type two hashes but leave out the space. Look at the preview. Why is it still ordinary text?
Source shown
# Garden meeting
## Decisions
Keep the reading bench.
##Actions
Mira will draw the layout.On screen
The Actions line has two hashes but no separating space; the preview keeps it as ordinary text.
8. Insert the missing space
The space is missing. Put the cursor between the hashes and Actions, and press Space.
Source shown
# Garden meeting
## Decisions
Keep the reading bench.
## Actions
Mira will draw the layout.On screen
A space is inserted after the two hashes. Actions becomes a level-two heading.
9. The words stay. The structure changes.
There it is. Decisions and Actions are now sections at the same level. Their paragraphs haven't changed. Only the structure has.
Source shown
# Garden meeting
## Decisions
Keep the reading bench.
## Actions
Mira will draw the layout.On screen
The cursor identifies the relevant source or preview area. Formatting changes follow the spoken instructions.
10. Your turn / Add a Next meeting section
Your turn. Pause here and add another section called Next meeting. Which heading marker will put it at the same level as Actions?
Source shown
# Garden meeting
## Decisions
Keep the reading bench.
## Actions
Mira will draw the layout.On screen
The cursor identifies the relevant source or preview area. Formatting changes follow the spoken instructions.
11. Two hashes + Space + section name
Use two hashes, a space, then Next meeting. Remember: the number of hashes sets the level. The space separates the marker from your words.
Source shown
# Garden meeting
## Decisions
Keep the reading bench.
## Actions
Mira will draw the layout.
## Next meetingOn screen
The cursor types a new Next meeting section, one character at a time.
A title, then useful sections
A meeting note can contain the right information and still be hard to use. A title identifies the document. Section headings tell the reader where to find a decision or an action.
For this style of heading, place one to six # characters at the beginning of a line, followed by a space and the heading text. More marks mean a deeper level. CommonMark heading syntax.
# Garden meeting
## Decisions
Keep the reading bench.
## Actions
Mira will draw the layout.Build a hierarchy the reader can follow
Use one main title for this exercise. Under it, use second-level headings for major sections. A third-level heading can divide one of those sections further. Make the heading describe its content: “Decisions” is more useful here than “More information”.
## Actions
### Before the next meeting
Sketch two possible layouts.Avoid choosing a heading level only because you prefer its font size. The structure should make sense even in a renderer with different styling.
Separate paragraphs clearly
Leave a blank line between paragraphs. A line break in the source alone is not generally a new paragraph. Blank lines around headings also make the source easier to scan. CommonMark paragraphs.
Practise with a rough note
Organize the supplied note into a title, decisions and actions. Then change a heading and watch the preview. The check looks for real heading tokens, so writing # inside a fenced code example will not pass as a document heading.
YOUR TURN
Make the idea your own.
Create one # title, a ## Decisions section and a ## Actions section. Put the relevant notes beneath each heading.
Readable result
Garden meeting Keep the reading bench. Mira will draw the layout.
Compare with one possible answer
# Garden meeting
## Decisions
Keep the reading bench.
## Actions
Mira will draw the layout.This is one approach. Your writing can differ while meeting the same structural goal.
TAKE IT WITH YOU
Use headings for a meaningful hierarchy, not just larger type.
Read the editor guide →Progress is stored in this browser. Your practice text is not saved.