How to Write in Markdown: A Practical Guide for Authors

Markdown is a plain text format with lightweight syntax for structuring content. Headings, bold, italic, lists — all written with simple characters. No menus, no toolbar, no formatting that breaks unexpectedly.

For book authors, Markdown offers a decisive advantage: the source file is clean, portable, and can be converted to any format (epub, PDF, DOCX) without pre-processing. That's why many professional authors have adopted it as their primary writing format.

Essential Markdown Syntax for a Book

You don't need to learn everything. Here's the 90% of Markdown useful for writing a book.

Headings

# Chapter 1: The Dawn

## I. The Forest

### A sub-section

One hash # = chapter heading (H1). Two hashes ## = subheading (H2). Three = sub-subheading (H3). These headings become the table of contents in your epub.

Bold and Italic

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

In literary prose, italic is used for inner thoughts, titles of works, and foreign words. Bold is rare in fiction.

Scene Separators

---

Three dashes produce a horizontal rule. In a novel, this creates a visual break between two scenes. Layout tools like Folio Studio can replace these separators with typographic ornaments based on the chosen template.

Quotes and Dialogue

In Markdown, quotation marks aren't handled specially — you type them directly:

She said: "I'm not coming back."

For block quotes (epigraphs, extracts):

> Life is short, art is long.
> -- Hippocrates

Footnotes

The syntax varies between tools, but the most common:

The text[^1] of your paragraph.

[^1]: Your footnote here.

Note: footnotes are well-supported in PDF but their rendering in epub varies across readers. Folio Studio converts them to end-of-chapter notes for epub.

Lists

- First item
- Second item
- Third item

1. First step
2. Second step
3. Third step

Lists are useful for essays, guides and practical books. Less common in fiction, but possible.

Advantages of Markdown for Authors

Focus on the Text

With Markdown, you write plain text. There's no Format menu, no styles to apply, no formatting that shifts based on your mood. The tool disappears; the text remains.

What you see on screen resembles the text you have in mind, with just enough visual cues (the # for headings, the * for italic) to make the structure readable without being intrusive.

Total Portability

A .md file is plain text. It opens in any text editor, on any system. You don't depend on any proprietary software. In ten years, your file will still be readable.

This portability also protects your work: proprietary formats (.docx, .pages) can create compatibility or conversion problems. Markdown doesn't have this problem.

Integration with Modern Tools

Many writing tools handle Markdown natively: Obsidian, iA Writer, Typora, Ulysses (Mac), VS Code with extensions. These tools offer real-time rendering, file management by project, and sometimes features like focus mode, word counting, or cloud sync.

Layout tools like Folio Studio import .md files directly without intermediate conversion.

Easy Version Control

Plain text files integrate perfectly with version control systems like Git. For an author who wants to track manuscript evolution, compare versions, or roll back after a rewrite, Git + Markdown is a powerful combination.

Best Tools for Writing in Markdown

Obsidian

Free, all systems

Obsidian is a Markdown-based note editor with a note-linking feature (for creating connections between characters, locations, events). Its popularity among authors comes from community plugins: Longform (for managing a novel chapter by chapter), Dataview (for creating project dashboards), and many others.

Obsidian stores everything locally on your machine. Sync is optional (paid).

iA Writer

Free trial then paid, all systems iA Writer is often cited as the most elegant Markdown editor. Minimalist interface, focus mode that dims everything except the current sentence, word count and session targets. It includes a real-time rendering preview.

Fewer features than Obsidian, but a more stripped-back writing experience. Ideal for intense writing sessions.

Typora

Paid ($14.99 one-time), Windows/Mac/Linux

Typora takes a unique approach: it doesn't show raw Markdown syntax. When you type **text**, you immediately see the text in bold. This "what you see is what you mean" rendering appeals to those who find raw syntax distracting.

VS Code with Markdown All in One Extension

Free, all systems

VS Code is a code editor that works perfectly well for writing books. The "Markdown All in One" extension adds a real-time preview, formatting shortcuts and an automatic table of contents. The advantage is native Git integration.

Not the most accessible tool for authors without technical experience, but for those comfortable with developer tools, it's very efficient.

Ulysses

Subscription ~$5/month, Mac/iPhone/iPad only

Ulysses is the reference Markdown editor in the Apple ecosystem. Text library management, writing targets, iCloud sync, direct epub and PDF export. The interface is polished and oriented toward long-form authors.

Apple ecosystem only.

Structuring a Novel in Markdown

Here are two approaches for organising a novel in Markdown.

Approach 1: Single File

All chapters in one file novel.md. Simple, easy to import into Folio Studio or convert with Pandoc.

# Chapter 1: The Dawn

The sun was rising over the silent forest...

---

# Chapter 2: The Meeting

Three days later...

This approach works well for short to medium novels (under 200 pages). For longer novels, the single file can become unwieldy.

Approach 2: One File Per Chapter

A novel/ folder with one file per chapter: 01-the-dawn.md, 02-the-meeting.md, etc. The numbering ensures correct ordering.

novel/
  00-foreword.md
  01-the-dawn.md
  02-the-meeting.md
  03-the-secret.md
  ...

When exporting, files are imported one by one into Folio Studio (which reorders them by filename), or passed in order to Pandoc:

pandoc 01-the-dawn.md 02-the-meeting.md 03-the-secret.md -o novel.epub

From Markdown to Published Book

The typical workflow for an author who writes in Markdown:

1. Write in Obsidian, iA Writer or your editor of choice
2. Edit and revise in the same tool
3. Import into Folio Studio: drag your .md file or import via the interface
4. Choose a template: Folio Studio detects chapters and applies typography
5. Export: epub for digital platforms, PDF for printing

This entire workflow can be completed without ever touching Word or complex layout software.

Markdown Writing Checklist

• Choose a Markdown editor suited to your system and preferences
• Structure chapters with # headings
• Use --- for scene separators
• Typographer's quotes directly in the text (" ")
• Single space after periods (not double)
• Numeric prefix in filenames if using multi-file approach (01-, 02-)
• Version with Git if your technical level allows it

---

FAQ

Do I need to learn Markdown to use Folio Studio?
No. Folio Studio also accepts Word files (.docx) and PDFs. Markdown is an option, not a requirement. But if you write in a Markdown editor, the import will be even cleaner than a Word file with poorly applied styles.

Can I include images in my Markdown?
Yes, with the syntax ![alt text](path/to/image.jpg). For a text novel, images are rarely needed. For an illustrated guide, images work in epub and PDF, provided the files are available when exporting.

Does Markdown handle em dashes for dialogue?
You can insert an em dash (—) directly into your Markdown file. Markdown syntax doesn't treat it specially — it's a Unicode character like any other. Layout tools will respect your input.

What's the best Markdown editor for Windows?
Typora ($14.99 one-time) and Obsidian (free) are the top choices for Windows. VS Code is excellent if you're comfortable with a code editor. iA Writer is cross-platform but best known on Mac.