The Markua Manual
Minimum price
Suggested price

The Markua Manual

How to Write in Markua on Leanpub

About the Book

Imagine you owned a magical typewriter.

When you used this magical typewriter, you wrote with fewer distractions. You didn't just write faster, you wrote better.

With your magical typewriter, you never worried about layout. The book formatted itself.

You could hit a key on your magical typewriter to create an ebook from your manuscript with one click.

All ebook formats would be created, and they'd all look good. You'd have PDF for computers and EPUB for everywhere else. The book would look great on phones.

With your magical typewriter, you could publish your book before it was even done, and get feedback from readers all over the world. You could automatically share book updates with them. You would press one key on your magical typewriter to publish a new version, and all your readers would have it instantly.

With your magical typewriter, you could easily compare your current manuscript to any other version of your manuscript that had ever existed.

When the book was done, if you decided to make a print book, you could press a key on your magical typewriter to generate InDesign with one click. Your designer or publisher could use this as a starting point for producing a great looking print book.

With your magical typewriter, you'd only have to do one thing: Write.

Wouldn't it be great if such a magical typewriter existed?

It does. At Leanpub, we're building it.

But there's one requirement for this magical typewriter to exist: a simple, coherent, open source, free, plain text format for a book manuscript.

This simple format is what authors will write their books in, instead of Word. It will enable an ecosystem of tools to emerge around it.

This simple format will be the basis for the magical typewriter.

This simple format is called Markua.

This is its user manual.

  • Share this book

  • Categories

    • Non-Fiction
  • Feedback

    You must own a copy of this Book to access the forums.

    Email the Author(s)

About the Author

Peter Armstrong
Peter Armstrong

Peter Armstrong is the founder and CEO of Leanpub. He has over two decades of experience in software, including eight years as a developer at Silicon Valley startups. He founded Ruboss in 2008, and launched Leanpub in 2010.

Peter coined the term Lean Publishing. Lean Publishing is the act of publishing an in-progress book using lightweight tools and many iterations to get reader feedback, pivot until you have the right book and build traction once you do.

Peter is the creator of Markua, the Markdown dialect used on Leanpub. He is the author of a number of books, including Lean PublishingThe Markua Manual and Programming for Kids. He has a BSc in Computer Science and Psychology from the University of Victoria, and he and his wife live in Victoria, BC.

Bundles that include this book

Bought separately
Minimum price
Bundle Price

Table of Contents

  • Introduction
    • The Magical Typewriter
    • How to Write a Novel in Markua 0.10
    • How to Write a Computer Programming Book in Markua
    • How to Write a Course in Markua
    • Markua: Markdown for Books and Courses
    • Why the Name “Markua”?
    • The Markua Manual vs. The Markua Spec
    • Markua 0.10 and Markua 0.30
    • Differences with Leanpub Flavoured Markdown (LFM)
    • Acknowledgments
  • Text Formatting
  • Headings
  • Paragraphs and Blank Lines
  • Resources
    • Resource Insertion Methods
    • Resource Locations
    • Resource Types and Formats
  • Whitespace: Spaces, Tabs and Newlines
    • Newlines
    • Spaces and Tabs
  • Lists
  • Definition Lists
  • Block Elements
    • Scene Breaks (* * *)
    • Blockquotes (>)
    • Asides (A> or {aside})
    • Blurbs (B> or {blurb})
  • Quizzes and Exercises
    • Quiz and Exercise Headings and Other Content
    • An Empty Quiz or Exercise is Not an Error
    • A Malformed Quiz or Exercise is an Error
    • Supported Attributes on Quizzes and/or Exercises
    • Question Types: Multiple Choice, Fill In The Blank
    • Creating a Course from a Markua Document
    • Question Alternates
  • Span Elements
    • Links
    • Explicitly Creating Spans with []
    • Footnotes and Endnotes
    • Crosslinks and ids
    • Character Substitution (X-- for X—, X -- for X –, ... for …)
    • Escaping Special Characters with Backslash (\)
    • Code Spans and Backticks (`)
  • Metadata
    • Attributes
    • Directives
    • Page Breaks
  • Appendices
    • No Inline HTML
    • Differences with Markdown

The Leanpub 60-day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

See full terms

80% Royalties. Earn $16 on a $20 book.

We pay 80% royalties. That's not a typo: you earn $16 on a $20 sale. If we sell 5000 non-refunded copies of your book or course for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earnedover $12 millionwriting, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub