Writing workflow
Markdown for Writers
By KenRich ยท Last updated: July 22, 2026
Markdown helps writers keep a draft readable before it becomes a finished page. It is useful for outlines, notes, essays, articles, newsletters, and blog posts because the source stays simple while the preview gives enough structure to review the work.
Write the shape before the style
A good draft starts with structure: title, sections, notes, and open questions. Markdown lets you shape that without choosing fonts, margins, or page layout too early.
For long drafts, headings and lists make the source easier to scan.
# Article Draft
## Working idea
State the argument in one plain paragraph.
## Reader problem
- What is confusing today?
- What does the reader want to finish?
## Draft notes
Keep rough notes here until they become sections.Article Draft
Working idea
State the argument in one plain paragraph.
Reader problem
- What is confusing today?
- What does the reader want to finish?
Draft notes
Keep rough notes here until they become sections.
NoteA skeleton keeps the draft moving before the final wording is ready.
Keep research notes close to the draft
Research notes are easier to use when they live near the paragraph they support. Use lists for source notes, blockquotes for copied excerpts you still need to rewrite, and links for material you will revisit.
Keep rough notes visibly rough. That makes it easier to separate finished copy from supporting material during revision.
## Evidence
- Interview note: users want fewer formatting choices.
- Product note: preview should make structure obvious.
- Link: [Markdown guide](/guide)
> Rewrite this quote before publishing.Evidence
- Interview note: users want fewer formatting choices.
- Product note: preview should make structure obvious.
- Link: Markdown guide
Rewrite this quote before publishing.
NoteBlockquotes are useful for temporary notes, but rewrite them before final copy.
Use small revision passes
A full rewrite is hard to manage in one pass. It is usually easier to revise structure first, then clarity, then examples, then final wording.
Markdown helps because the source stays visible. You can move sections, split paragraphs, and keep a small checklist without fighting layout.
## Revision pass
- [ ] Does the title match the draft?
- [ ] Does each section answer one question?
- [ ] Are examples close to the claims they support?
- [ ] Can one paragraph be removed?Revision pass
- [ ] Does the title match the draft?
- [ ] Does each section answer one question?
- [ ] Are examples close to the claims they support?
- [ ] Can one paragraph be removed?
NoteCheckboxes make editing tasks visible without turning the draft into a project tracker.
Move from rough notes to publishable copy
When the draft starts to settle, remove notes that only helped you think. Keep headings, short paragraphs, useful links, and examples that support the reader.
Markdown is a good publishing handoff because the same source can become HTML, documentation, a newsletter draft, or a blog post.
## Why the preview matters
A preview catches structure problems before readers see them. Long paragraphs, broken lists, and missing links are easier to fix while the draft is still in Markdown.
Read the [Markdown Basics](/docs/markdown-basics) guide if the source format is new to you.Why the preview matters
A preview catches structure problems before readers see them. Long paragraphs, broken lists, and missing links are easier to fix while the draft is still in Markdown.
Read the Markdown Basics guide if the source format is new to you.
NoteFinished sections should read naturally even before final styling.
Move important drafts to desktop
The browser editor is useful for quick starts. When a draft becomes important, move to desktop so the file lives locally, can be reopened, and can benefit from local history snapshots.
For essays, client drafts, product copy, and long articles, a local file is easier to back up, compare, and keep under your own control.
Keep the writing surface quiet
A quiet writing surface still needs tools. The editor gives you headings, preview, export, and recovery without pulling attention away from the draft.
A practical habit is to write in small sections, preview often, and move stable drafts into local files. That keeps the browser useful for starting and the desktop app useful for finishing.