Convert Markdown to FB2

Drag and drop files here or click to select.
Max file size 100mb.
Uploading progress:

Markdown vs FB2 Format Comparison

Aspect Markdown (Source Format) FB2 (Target Format)
Format Overview
Markdown
Lightweight Markup Language

Lightweight markup language created by John Gruber in 2004. Uses simple plain-text symbols for formatting (# for headings, ** for bold). Widely adopted on GitHub, Stack Overflow, Reddit, and documentation platforms. Designed to be readable as raw text and easily convertible to HTML.

Plain Text Developer Friendly
FB2
FictionBook 2.0

XML-based e-book format created in Russia, extremely popular in Russian-speaking countries and Eastern Europe. Stores the entire book structure (metadata, chapters, images) in a single XML file. Supported by hundreds of reading applications and e-reader devices, especially those manufactured for the Russian and CIS markets.

XML-Based Popular in Russia/CIS
Technical Specifications
Structure: Plain text with formatting symbols
Encoding: UTF-8
Format: Human-readable markup
Compression: None
Extensions: .md, .markdown
Structure: Single XML file with strict schema
Encoding: UTF-8 or Windows-1251
Format: XML with FictionBook DTD
Compression: Often distributed as .fb2.zip
Extensions: .fb2, .fb2.zip
Syntax Examples

Markdown uses simple symbols:

# Book Title

## Chapter 1

A paragraph with **bold** text
and *italic* words.

- List item one
- List item two

> A blockquote passage

FB2 uses structured XML:

<FictionBook>
  <body>
    <title><p>Book Title</p></title>
    <section>
      <title><p>Chapter 1</p></title>
      <p>A paragraph with
        <strong>bold</strong> text.</p>
    </section>
  </body>
</FictionBook>
Content Support
  • Headings (6 levels)
  • Bold, italic, strikethrough
  • Ordered and unordered lists
  • Links and images
  • Code blocks and inline code
  • Blockquotes
  • Tables (GFM extension)
  • Horizontal rules
  • Structured book sections
  • Bold, italic, emphasis
  • Footnotes and endnotes
  • Embedded images (Base64)
  • Poems and stanzas
  • Epigraphs and citations
  • Table of contents
  • Rich metadata (author, genre, annotation)
  • Cover image support
Advantages
  • Extremely easy to write
  • No special software needed
  • Version control friendly
  • Universally readable as text
  • Converts to many formats
  • Huge ecosystem of tools
  • Rich semantic book structure
  • Single self-contained file
  • Excellent for fiction and literature
  • Massive library of existing books
  • Widely supported in Russia/CIS
  • Small file sizes
  • Footnotes and annotations
Disadvantages
  • Limited formatting capabilities
  • No book-specific metadata
  • No pagination control
  • No embedded font support
  • Multiple competing dialects
  • Limited adoption outside Russia/CIS
  • No CSS styling support
  • Basic table support
  • Images stored as Base64 (larger files)
  • Less common in Western markets
Common Uses
  • GitHub documentation
  • Blog posts and articles
  • Technical writing
  • Note-taking applications
  • Static site generators
  • Fiction and literature distribution
  • Russian-language e-book libraries
  • E-reader devices (PocketBook, ONYX)
  • Mobile reading applications
  • Online book archives (Flibusta, lib.ru)
  • Self-publishing in Russia/CIS
Best For
  • Writing content quickly
  • Developer documentation
  • Source content for publishing
  • Platform-agnostic authoring
  • Fiction and literary e-books
  • Russian/CIS market distribution
  • PocketBook and ONYX readers
  • Compact e-book storage
Version History
Introduced: 2004 (John Gruber)
Current Standard: CommonMark (2014+)
Status: Actively used and evolving
Variants: GFM, CommonMark, MultiMarkdown
Introduced: Early 2000s (Russia)
Current Version: FictionBook 2.1
Status: Stable, widely used in CIS
Evolution: FB2 → FB2.1 (FB3 proposed)
Software Support
Editors: VS Code, Typora, Obsidian, any text editor
Platforms: GitHub, GitLab, Reddit, Stack Overflow
Converters: Pandoc, Marked, markdown-it
Other: Jupyter, Notion, Confluence
Desktop: Calibre, FBReader, CoolReader
Mobile: FBReader, Moon+ Reader, AlReader
E-Readers: PocketBook, ONYX BOOX
Other: fb2edit, OOoFBTools

Why Convert Markdown to FB2?

Converting Markdown to FB2 (FictionBook 2) is essential when you need to distribute e-books in Russian-speaking countries and Eastern Europe, where FB2 is one of the most popular e-book formats. While EPUB dominates Western markets, FB2 has a massive user base across Russia, Ukraine, Belarus, and other CIS countries, with millions of books available in this format through online libraries and distribution platforms.

Markdown, created by John Gruber in 2004, provides an excellent authoring experience for writing book content. Its simple syntax allows authors to focus on writing without distraction, while the plain-text format ensures compatibility with version control systems like Git. When your Markdown manuscript is ready, converting to FB2 packages your content into the structured XML format that FB2 readers expect, complete with proper chapter divisions, metadata, and formatting.

FB2's XML-based structure maps well to Markdown content. Markdown headings become FB2 section titles, paragraphs remain paragraphs, bold and italic formatting is preserved, and blockquotes can be represented as FB2 citations or epigraphs. The FB2 format also supports rich metadata (author, genre, annotation, keywords) that helps readers discover and organize your e-book.

A key advantage of FB2 is its self-contained nature -- the entire book, including images (stored as Base64), metadata, and content, lives in a single XML file. This makes FB2 files easy to share, archive, and manage. The format is supported by numerous reading applications (FBReader, CoolReader, Moon+ Reader) and e-reader devices (PocketBook, ONYX BOOX) that are widely used in Eastern Europe.

Key Benefits of Converting Markdown to FB2:

  • CIS Market Access: Reach millions of readers in Russia and Eastern Europe
  • Structured Content: Proper chapter divisions and section hierarchy
  • Rich Metadata: Author, genre, annotation, and keyword support
  • Self-Contained: Single XML file with embedded images
  • Device Support: Compatible with PocketBook, ONYX BOOX, and many more
  • App Compatibility: Works with FBReader, CoolReader, Moon+ Reader
  • Compact Files: Small file sizes, efficient for distribution

Practical Examples

Example 1: Fiction Novel

Input Markdown file (novel.md):

# The Last Winter

## Chapter 1: The Arrival

The train pulled into the station just as
the first snowflakes began to fall.

**"Welcome to Novosibirsk,"** said the
conductor with a tired smile.

## Chapter 2: Old Friends

> "Some friendships survive any distance."

Maria hadn't changed at all.

Output FB2 file (novel.fb2):

Structured FB2 e-book with:
✓ Book title and author metadata
✓ Chapter sections with titles
✓ Bold text and emphasis preserved
✓ Blockquotes as FB2 citations
✓ Compatible with FBReader
✓ Ready for PocketBook devices
✓ Single self-contained XML file

Example 2: Short Story Collection

Input Markdown file (stories.md):

# Collected Short Stories

## The Clock Tower

The old clock tower had stood for centuries...

## The Garden

*Every spring, the garden came alive...*

## The Letter

She found the letter hidden behind the mirror.
It was dated **March 15, 1923**.

Output FB2 file (stories.fb2):

FB2 story collection with:
✓ Each story as a separate section
✓ Navigable table of contents
✓ Italic and bold formatting
✓ Clean paragraph structure
✓ Works with Moon+ Reader
✓ Suitable for CoolReader
✓ Easily shared as single file

Example 3: Non-Fiction Guide

Input Markdown file (guide.md):

# Photography for Beginners

## Understanding Exposure

Three key elements control exposure:

1. **Aperture** — controls depth of field
2. **Shutter Speed** — controls motion blur
3. **ISO** — controls sensor sensitivity

## Composition Rules

- Rule of thirds
- Leading lines
- Framing

Output FB2 file (guide.fb2):

Non-fiction FB2 e-book:
✓ Ordered and unordered lists
✓ Bold text within list items
✓ Section-based navigation
✓ Structured chapter hierarchy
✓ Portable single-file format
✓ Compatible with all FB2 readers
✓ Metadata for categorization

Frequently Asked Questions (FAQ)

Q: What is the FB2 format?

A: FB2 (FictionBook 2) is an XML-based e-book format created in Russia. It stores the complete book structure -- metadata, content, and images -- in a single XML file. FB2 is extremely popular in Russian-speaking countries and Eastern Europe, with millions of books available in this format. It's supported by numerous reading applications and e-reader devices.

Q: Will my Markdown formatting be preserved in FB2?

A: Yes! Core Markdown formatting converts well to FB2. Headings become section titles, bold and italic text are preserved, lists maintain their structure, and blockquotes can be represented as citations. However, FB2 has limited support for some Markdown features like tables and code blocks, which may be rendered as plain text.

Q: Where is FB2 commonly used?

A: FB2 is predominantly used in Russia, Ukraine, Belarus, Kazakhstan, and other CIS countries. Major platforms like Litres.ru, Flibusta, and lib.ru distribute books in FB2 format. E-reader manufacturers popular in these regions (PocketBook, ONYX BOOX) provide excellent FB2 support. The format is also supported globally by apps like FBReader and Calibre.

Q: Can I read FB2 files on Western e-readers?

A: While Amazon Kindle and Apple Books don't natively support FB2, you can read FB2 files using free applications like FBReader (available on Windows, Mac, Linux, Android, iOS), CoolReader, or Moon+ Reader. You can also convert FB2 to EPUB or MOBI using Calibre for use on Kindle and other Western devices.

Q: How does FB2 store images?

A: FB2 embeds images directly in the XML file using Base64 encoding. This means the entire book (text, images, cover) is contained in a single .fb2 file, making it easy to share and distribute. The downside is that Base64-encoded images are about 33% larger than the original binary files, though FB2 files are often compressed as .fb2.zip to offset this.

Q: What metadata does FB2 support?

A: FB2 has rich metadata support including: title, author (first name, middle name, last name), genre (from a predefined list), annotation/description, keywords, date, language, series information, and publisher details. This metadata is stored in the XML structure and used by reading applications for library organization and book discovery.

Q: Is FB2 better than EPUB?

A: It depends on your audience. For Russian-speaking readers and Eastern European markets, FB2 is often preferred due to its massive ecosystem and device support. For international distribution, EPUB is the better choice. FB2 excels at structured fiction with footnotes and annotations, while EPUB offers more advanced styling with CSS. Many authors publish in both formats.

Q: Can I convert FB2 back to Markdown later?

A: Yes! FB2's XML-based structure makes it relatively easy to convert back to Markdown. Tools like Pandoc and Calibre can perform FB2-to-Markdown conversion. Since FB2 preserves document structure (sections, paragraphs, emphasis), the round-trip conversion typically produces clean Markdown output with headings, formatting, and content intact.