[docizr-book]

Dividing Your Document ^Beginner

[/docizr-book]

As your documents grow longer, you will want to create clear visual boundaries between different topics or sections. A thematic break is a horizontal line that separates one part of a document from another. In Markdown you create one by typing three hyphens on a line by themselves.

It is one of the simplest things you can write in Markdown — and one of the most far-reaching. The same three-character mark that divides sections in a document also tells Markdown-based presentation tools where one slide ends and the next begins.

What You Will Need

Your Markdown editor, open and ready. Start with a fresh document.

Workflow

Step 1

Aim: write your first thematic break.

Type three hyphens on a line by themselves, with a blank line above and a blank line below. That is all there is to it.

This section is about planning your trip.

---

This section is about packing.

In the preview you should see a horizontal line separating the two paragraphs. It has no label — it is a visual pause, like a scene change or a breath between ideas.

Step 2

Aim: use a thematic break to separate two sections.

A thematic break works best between two genuinely distinct topics within the same document — not between every paragraph, but where the reader truly moves from one idea to a different one.

## Before You Go

Make a list of everything you need to do in the week before your trip. Book airport parking, arrange for someone to water your plants, and check that your passport is still valid.

---

## On the Day

Pack your bags the evening before. Leave time for one last check of the house — windows closed, heating turned down, front door locked.

The break creates a clean visual boundary between the two sections. Even if the headings were removed, a reader would still feel the shift.

Step 3

Aim: use thematic breaks to structure a longer document.

Here is a short community newsletter using breaks to separate each item. Notice how the breaks help the eye move from one story to the next without the sections merging together.

# The Village Green — May 2026

## Flower Show Returns This Saturday

After a two-year break, the annual village flower show is back. Gates open at 10 am on the village green. Admission is free for children under 12.

---

## New Café Opening on High Street

A new independent café, **The Pressed Leaf**, opens its doors on Friday 16 May. The owners, who previously ran a bakery in Edinburgh, are offering a free coffee to the first fifty customers.

---

## Notice: Road Closure on Elm Avenue

Elm Avenue will be closed to traffic from Monday 19 May to Friday 23 May for resurfacing. Residents will be contacted directly with details of alternative parking.

Step 4

Aim: understand why thematic breaks matter for presentations.

Here is something worth knowing now, even if you are not yet working with slides.

Many popular Markdown-based presentation tools — including Marp, Slidev, and the slide export options in apps like Obsidian and Typora — treat the thematic break (---) as a slide boundary. Every time you write ---, those tools start a new slide.

This means a well-structured Markdown document — with thematic breaks already in the right places — can become a slide presentation with almost no extra work.

# My Presentation Title

This is the content of the first slide.

---

## Second Slide

Here is the content of the second slide.

---

## Third Slide

And here is the third.

In a standard Markdown preview this looks like a three-section document with horizontal dividers. Open the same file in Marp or a similar tool and each section between the --- marks becomes a separate slide.

Step 5

Aim: review what you have learned.

The thematic break is three characters — --- — on a line of its own, with a blank line above and below. It does two different jobs depending on how the document is used:

• In a document or website: it draws a horizontal rule between sections
• In a presentation tool: it marks the boundary between slides

A few habits worth forming now:

• Always leave a blank line above and below --- — some Markdown parsers require this, and it makes your source easier to scan
• Use breaks between topics, not between every paragraph
• When writing something that might one day become a slide deck, use --- consciously — each one is a future slide transition

# The Village Green — May 2026

## Flower Show Returns This Saturday

After a two-year break, the annual village flower show is back. Gates open at 10 am.

---

## New Café Opening on High Street

A new independent café, **The Pressed Leaf**, opens its doors on Friday 16 May.

---

## Notice: Road Closure on Elm Avenue

Elm Avenue will be closed from Monday 19 May to Friday 23 May for resurfacing.

You now know how to divide a document clearly — and you have a technique in your toolkit that will unlock presentations later. The next workflow shows you how to add links to your text, one of the most useful things Markdown can do.