You have learned the individual pieces. Now it is time to put them together.
This workflow guides you through writing a complete Markdown article from start to finish — a short travel piece about a weekend in the Cotswolds. Along the way, you will use headings, paragraphs, emphasis, lists, a thematic break, a blockquote, a link, a table, and an image. Every technique you have practised in the previous workflows appears here in natural context.
By the end, you will have a finished article and a clear sense of how Markdown fits together as a whole.
What You Will Need
Your Markdown editor, open and ready. Start with a blank document.
If you have a photo from a real trip, you are welcome to substitute it in Step 4. Otherwise the image step uses a placeholder that you can fill in later.
Workflow
Step 1
Aim: write the article title and opening paragraphs.
Every article starts with a title and an introduction. Use a top-level heading (#) for the title, and write two or three paragraphs to set the scene.
# A Weekend in the Cotswolds
The Cotswolds do not ask very much of you. There is no agenda, no checklist, no monument you are obliged to photograph. You walk when you feel like it, stop when something catches your eye, and eat lunch somewhere with low beams and a menu written on a chalkboard.
We went in early October, when the tourist season had quietened down and the trees had just started to turn. The villages were almost empty on Saturday morning. By Sunday afternoon we were wondering why we had not come sooner.
A Weekend in the Cotswolds
The Cotswolds do not ask very much of you. There is no agenda, no checklist, no monument you are obliged to photograph. You walk when you feel like it, stop when something catches your eye, and eat lunch somewhere with low beams and a menu written on a chalkboard.
We went in early October, when the tourist season had quietened down and the trees had just started to turn. The villages were almost empty on Saturday morning. By Sunday afternoon we were wondering why we had not come sooner.
Step 2
Aim: add a section with emphasis and a list.
Use a second-level heading to open a new section. Include some bold or italic text where it adds meaning, and use a list to present information that naturally fits that shape.
## Where We Stayed
We booked a room at a small bed and breakfast in Bourton-on-the-Water — **highly recommended**, though you should book well in advance if you are going in summer. It was the kind of place where breakfast appears at exactly the time you asked for it and the host knows which footpaths are worth taking.
Things we packed that turned out to be useful:
- Waterproof walking shoes — the paths can be muddy even in dry weather
- A light fleece — October mornings are cool even when the afternoon turns warm
- A paper map — phone signal is patchy in some of the smaller villages
- Cash — a few of the farm stalls and village tearooms do not take cards
Where We Stayed
We booked a room at a small bed and breakfast in Bourton-on-the-Water — highly recommended, though you should book well in advance if you are going in summer. It was the kind of place where breakfast appears at exactly the time you asked for it and the host knows which footpaths are worth taking.
Things we packed that turned out to be useful:
- Waterproof walking shoes — the paths can be muddy even in dry weather
- A light fleece — October mornings are cool even when the afternoon turns warm
- A paper map — phone signal is patchy in some of the smaller villages
- Cash — a few of the farm stalls and village tearooms do not take cards
Step 3
Aim: add a quote and a thematic break.
Use a blockquote to highlight something memorable, and a thematic break to signal the move to the next section of the article.
## Saturday
The walk from Bourton to Lower Slaughter takes about thirty minutes along the river. We had the path almost entirely to ourselves.
> There are walks you take for the exercise and walks you take for the view. This was the third kind — the kind where you stop thinking about anything at all.
---
## Sunday
Sunday was quieter still. We drove to Chipping Campden in the morning and spent an hour in the market hall before finding a pub for an early lunch.
Saturday
The walk from Bourton to Lower Slaughter takes about thirty minutes along the river. We had the path almost entirely to ourselves.
There are walks you take for the exercise and walks you take for the view. This was the third kind — the kind where you stop thinking about anything at all.
Sunday
Sunday was quieter still. We drove to Chipping Campden in the morning and spent an hour in the market hall before finding a pub for an early lunch.
Step 4
Aim: add an image with a caption.
Place a photo in the article to illustrate the scene. Use an italic line below the image as a caption.
## The Villages
*REPLACE: write a short caption here — for example: The mill pond at Lower Slaughter, looking south on a still October morning.*
Lower Slaughter is the smaller and quieter of the two Slaughter villages. The stream that runs through the centre is barely wider than a garden path, and the old mill at the end still has its wheel intact.
The Villages
[Image placeholder — add your Cotswolds photo to see it here]
REPLACE: your caption goes here
Lower Slaughter is the smaller and quieter of the two Slaughter villages. The stream that runs through the centre is barely wider than a garden path, and the old mill at the end still has its wheel intact.
Step 5
Aim: add a table and a link.
Use a table to present comparison information clearly, and a link to point the reader to a useful resource.
## Getting There
We drove from Oxford, which takes about forty minutes. If you are coming by public transport, the options are limited — most visitors find a car is worth hiring.
| Starting Point | Route | Approximate Time |
| --- | --- | --- |
| London | Train to Moreton-in-Marsh, then taxi | 2 hours |
| Oxford | Drive via A40 | 45 minutes |
| Birmingham | Drive via A46 | 1 hour |
| Bristol | Drive via A429 | 1 hour 15 minutes |
Full travel options and seasonal timetables are on the [Cotswolds tourism website](https://www.cotswolds.com).
Getting There
We drove from Oxford, which takes about forty minutes. If you are coming by public transport, the options are limited — most visitors find a car is worth hiring.
| Starting Point | Route | Approximate Time |
|---|---|---|
| London | Train to Moreton-in-Marsh, then taxi | 2 hours |
| Oxford | Drive via A40 | 45 minutes |
| Birmingham | Drive via A46 | 1 hour |
| Bristol | Drive via A429 | 1 hour 15 minutes |
Full travel options and seasonal timetables are on the Cotswolds tourism website.
Step 6
Aim: write a closing paragraph and review the complete article.
Finish the piece with a short closing paragraph that leaves the reader with something to take away. Then read the full article from start to finish.
## Would We Go Back?
Without hesitation. The Cotswolds repay a slower pace than most people give them. If you go expecting to tick off a list of villages, you will feel vaguely dissatisfied. If you go expecting to slow down, you will wonder how a weekend can feel both too short and exactly right at the same time.
Now assemble the full article and read it through. Check that the headings tell a clear story, the emphasis adds meaning rather than decoration, the list is easier to scan than a paragraph would be, and the table is clearer than prose. If something feels off, edit it — that is what Markdown is for.
Would We Go Back?
Without hesitation. The Cotswolds repay a slower pace than most people give them. If you go expecting to tick off a list of villages, you will feel vaguely dissatisfied. If you go expecting to slow down, you will wonder how a weekend can feel both too short and exactly right at the same time.
You have now written a complete Markdown article — with structure, emphasis, a list, a blockquote, a thematic break, an image, a table, and a link. Every piece of Markdown you have learned is in there. The final workflow looks at what you can do with that article once it is written: where to save it, where to share it, and where to go next.