You have written Markdown. You have used headings, paragraphs, lists, emphasis, links, images, blockquotes, tables, and thematic breaks. You have the core of the language firmly in hand.
The natural next question is: now that you have a .md file, what can you actually do with it?
The short answer is: quite a lot. This final workflow in the series answers that question and points you towards wherever you want to go next.
What You Will Need
Your Markdown editor and the article you wrote in the previous workflow — or any Markdown file you like.
Workflow
Step 1
Aim: save your file.
If you have been typing into an online editor or a preview tool, now is the time to save your work as a real file. A Markdown file is a plain text file with a .md extension.
When you save:
- Name the file something descriptive, such as
cotswolds-weekend.md - Choose a folder you will remember — a
WritingorDocumentsfolder is fine - Make sure the extension is
.md, not.txt(you may need to type it yourself in some apps)
That is your file. It is a plain text document. You can open it in any text editor on any computer, now or years from now. Nothing about it will stop working.
Step 2
Aim: understand where Markdown is accepted.
Many tools and platforms accept Markdown directly — you paste or upload your .md file and the formatting is applied automatically.
| Platform or Tool | What It Does | Good For |
|---|---|---|
| Ghost | Writing and publishing platform | Blogs, newsletters |
| Hugo | Static website generator | Personal sites, documentation |
| Obsidian | Personal knowledge base | Notes, research, journalling |
| Notion | All-in-one workspace | Notes, project planning |
| HackMD | Collaborative Markdown editor | Shared documents |
| Marp | Markdown to presentation slides | Presentations |
| Pandoc | Document converter | EPUB, PDF, Word, HTML |
Most of these tools are free to start with. Pandoc is free and open source — it is the tool that converts Markdown to almost any other format, including Word documents, PDFs, and ebooks.
Step 3
Aim: convert your Markdown to HTML or another format.
If the platform you are using does not accept Markdown directly, you can convert it. Pandoc is the standard tool for this. You point it at your .md file and it produces a Word document, an HTML page, a PDF, or an EPUB — your choice.
Note: Pandoc requires a short setup step before you can use it. Instructions and download links are on the Pandoc website.
Once Pandoc is installed, one command converts your Markdown article to a Word document. The exact steps depend on which app you use to run commands — but the Pandoc website has clear guides for Windows, macOS, and Linux.
Step 4
Aim: explore what to learn next.
You have covered the core of Markdown. From here, the path forks depending on what you want to do.
If you want to write better documents:
- Learn about footnotes — supported in Pandoc, MultiMarkdown, and Obsidian
- Learn about definition lists — useful for glossaries and reference pages
- Explore YAML frontmatter — metadata that goes at the top of a file and controls how it is published
If you want to build a website:
- Hugo is the most popular static site generator using Markdown
- Ghost is the easiest publishing platform if you want a blog without writing any code
- Grav is a good choice if you want a CMS that is flexible and file-based
If you want to make presentations:
- Marp is the simplest — it turns your Markdown directly into slides
- Slidev is more powerful and lets you include interactive elements
If you want to publish a book or long document:
- Pandoc is the standard tool — it converts Markdown to EPUB, PDF, and Word
- Quarto is worth looking at if your work involves data, charts, or academic references
Step 5
Aim: watch a short video overview.
Video: A short video introduction to Markdown is available on YouTube.
Watch: Introduction to Markdown
[Video placeholder — replace
[REPLACE_WITH_VIDEO_ID]in the URL above with the actual YouTube video ID before publishing this page.]
You have completed the workflows series. You started with a blank document and plain text. You now have a language — one that works everywhere, that will never go out of date, and that takes seconds to learn and a lifetime to use well.
Whatever you write next, Markdown is ready when you are.