Creative Tools

Writing With Markdown: The Plain-Text Format Every Writer Should Know

By YPen Published · Updated

Writing With Markdown: The Plain-Text Format Every Writer Should Know

Markdown is a lightweight formatting language that lets you write formatted text using plain text. Created by John Gruber in 2004, it was designed with one goal: a format that’s readable as plain text and convertible to HTML (and other formats) with minimal effort.

For writers, Markdown solves a persistent problem: the tension between writing and formatting. In Word or Google Docs, formatting decisions constantly interrupt the writing process—should this be bold? What heading level? How do I make a list? Markdown lets you add formatting with a few simple characters and keep writing without reaching for a toolbar.

The Basics in Five Minutes

Markdown’s syntax is intentionally minimal. You can learn the essentials in five minutes and start using them immediately.

Headings

Prefix a line with hash marks:

# Heading 1
## Heading 2
### Heading 3

The number of hash marks determines the heading level. Most writers use Heading 1 for the title, Heading 2 for major sections, and Heading 3 for subsections.

Emphasis

Wrap text in asterisks or underscores:

*italic* or _italic_
**bold** or __bold__
***bold italic***

Single asterisks for italic. Double for bold. Triple for both.

Lists

Bulleted lists use dashes, asterisks, or plus signs:

- First item
- Second item
- Third item

Numbered lists use numbers followed by periods:

1. First item
2. Second item
3. Third item

Square brackets for the text, parentheses for the URL:

[YPen](https://ypen.com)

Block Quotes

Prefix with a greater-than sign:

> This is a block quote. It's useful for
> quoting other sources or setting text apart.

Horizontal Rules

Three or more dashes, asterisks, or underscores on their own line:

---

That’s the core of Markdown. With headings, emphasis, lists, links, and block quotes, you can format 90% of the writing most people produce.

Why Markdown Matters for Writers

Distraction-Free Writing

Markdown formatting is typed, not clicked. You never leave the keyboard to reach for a toolbar button. Your hands stay in writing position, and your eyes stay on the text. The formatting decisions happen in the flow of writing rather than interrupting it.

Portable and Permanent

Markdown files are plain text (.md or .txt). They open in any text editor on any operating system. They’ll be readable in fifty years. They can’t be corrupted by a software update. They don’t require a subscription.

Compare this to Word documents, which require specific software, can become corrupted, and sometimes lose formatting across versions. Or Google Docs, which requires an internet connection and a Google account.

Your writing in Markdown belongs to you permanently, in a format that will always be accessible.

Convertible to Anything

Markdown converts to HTML (for the web), PDF (for print), DOCX (for editors who want Word files), EPUB (for ebooks), and many other formats. Write once in Markdown, output to whatever format is needed.

Tools like Pandoc (free, command line) handle conversions. Most Markdown writing apps include export features built in.

Version Control Friendly

Because Markdown is plain text, it works with version control systems like Git. Writers who use Git for manuscript management can track every change, compare versions, and collaborate without merge conflicts. See [INTERNAL: version-control-for-writers] for this workflow.

Where to Write Markdown

Dedicated Markdown Editors

iA Writer ($50, Mac/Windows/iOS/Android): Beautiful typography, focus mode, and clean interface. The premier Markdown writing experience. See [INTERNAL: ulysses-vs-ia-writer].

Typora ($15, Mac/Windows/Linux): A unique “what you see is what you mean” approach—Markdown syntax is rendered in real time as you type. Headings appear as headings, bold appears bold, but you’re still writing in Markdown.

Obsidian (free, Mac/Windows/Linux/iOS/Android): A knowledge management tool built on Markdown files. Each note is a .md file. Excellent for writers who want to link ideas together. Covered in [INTERNAL: obsidian-for-writers].

Mark Text (free, open source): A simple, clean Markdown editor. Good for writers who want a free option without feature bloat.

General-Purpose Editors

VS Code (free): The popular code editor handles Markdown well with preview panes and extensions.

Sublime Text ($99, one-time): Fast, clean, and capable. Works for both code and prose.

Online Tools

HackMD / CodiMD: Collaborative Markdown editing in the browser. Useful for co-writing or sharing drafts.

StackEdit: A browser-based Markdown editor that syncs with Google Drive and Dropbox.

Markdown for Different Writing Types

Blog Posts and Web Content

Markdown was designed for web writing. Most blogging platforms (WordPress, Ghost, Jekyll, Hugo) support Markdown natively. Write your post in Markdown, paste it into the platform, and the formatting translates automatically.

Books and Long-Form Writing

Markdown works well for book-length projects when combined with organizational tools. Each chapter as a separate .md file, organized in folders. Compile tools (Pandoc, Scrivener’s Markdown import, or Vellum with conversion) produce formatted manuscripts for submission or self-publishing.

Notes and Knowledge Management

Markdown notes are the foundation of personal knowledge management systems like Zettelkasten. Tools like Obsidian build entire knowledge bases from interconnected Markdown files. The simplicity of the format means your notes are never locked into a proprietary system.

Academic Writing

With extensions like Pandoc’s citation syntax, Markdown handles academic formatting including footnotes, bibliographies, and cross-references. Several academics have abandoned LaTeX for Markdown-based workflows that are simpler to write and maintain.

Extended Syntax

Beyond the basics, Markdown supports additional formatting:

Tables

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Row 1    | Data     | Data     |
| Row 2    | Data     | Data     |

Footnotes

Here is a sentence with a footnote.[^1]

[^1]: This is the footnote content.

Task Lists

- [x] Completed task
- [ ] Incomplete task

Code Blocks

Triple backticks create code blocks (useful for technical writing):

```
This is a code block
```

Strikethrough

~~deleted text~~

Not all Markdown processors support all extended syntax. The basics (headings, emphasis, lists, links, quotes) are universal.

The Markdown Workflow

A practical writing workflow using Markdown:

  1. Draft in a Markdown editor. Write freely, adding formatting as you go. Headings, bold, lists—whatever the content needs.
  2. Revise in the same editor. Markdown’s clean format makes revision easy—no formatting distractions.
  3. Export to the needed format. PDF for print, DOCX for editors, HTML for the web.
  4. Archive the Markdown file. Your permanent, portable, future-proof copy.

The Learning Curve

Markdown’s learning curve is measured in minutes, not hours. The basic syntax—which covers the vast majority of writing needs—can be memorized in a single sitting. The extended syntax takes a bit longer but is only needed for specific use cases.

The harder adjustment is psychological: trusting that plain text with a few special characters will produce properly formatted output. Writers accustomed to WYSIWYG editors (where formatting is visible immediately) may feel uncertain writing in what looks like raw text. This discomfort fades quickly once you see the converted output and realize it works.

Markdown isn’t the right tool for every writing situation. Heavily designed documents (magazines, brochures, complex layouts) need design software. Collaborative editing with non-technical people often works better in Google Docs. But for the act of writing—getting words out of your head and onto a page with basic formatting—Markdown is the most efficient, most portable, and most permanent format available.