The Markua 0.29 Beta Manual
The Markua 0.29 Beta Manual
Free!
Minimum price
$0.00
Suggested price
The Markua 0.29 Beta Manual

Last updated on 2019-11-11

About the Book

About the Author

Peter Armstrong
Peter Armstrong

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

Peter is also the author of a number of books, including Lean Publishing, The Markua Specification and Programming for Kids. He has a BSc in Computer Science and Psychology from the University of Victoria.

Peter coined the term "lean publishing" to describe the act of self-publishing an in-progress ebook. Leanpub was created based on the principles of lean publishing. He lives in Victoria, BC with his wife and son.

Table of Contents

  • Introduction
    • The Magical Typewriter
    • How to Write a Novel in Markua
    • How to Write a Computer Programming Book in Markua
    • How to Write a Course (MOOC) in Markua
    • Markua: Markdown for Books and Courses
    • Why the Name “Markua”?
    • The Markua Manual vs. The Markua Spec
    • Differences with Leanpub Flavoured Markdown (LFM)
    • Acknowledgments
  • Text Formatting
  • Headings
  • Paragraphs and Blank Lines
  • Resources
    • Resource Insertion Methods
      • Figures
      • Spans
      • Inserting Resources Into a Span Context
    • Resource Locations
      • Local Resources
      • Web Resources
      • Inline Resources
    • Resource Types and Formats
      • Images
      • Video
      • Audio
      • Code
      • Math
      • Tables
  • Whitespace: Spaces, Tabs and Newlines
    • Newlines
      • Single Newline = Forced Line Break
      • Three or More Newlines = Two Newlines = One Blank Line
      • One Blank Line Is Added When Concatenating Manuscript Files
      • All Blank Lines at the Beginning and End of a File are Removed
    • Spaces and Tabs
      • Spaces and Tabs at the Beginning of a Line are Only to Determine List Containment, and Extra Spaces are Removed
      • Spaces and Tabs at the End of a Line are Removed
      • Internal Spaces are Collapsed to One Space, Except At the End of Sentences
  • Lists
  • Definition Lists
  • Block Elements
    • Scene Breaks (* * *)
    • Blockquotes (>)
    • Asides (A> or {aside})
    • Blurbs (B> or {blurb})
      • Supported Attributes for Blurbs
      • Syntactic Sugar for Specific Blurb Classes: D>, E>, I>, Q, T, W>, X>
      • Using Blurbs to Center Text with C>
      • Using Extension Attributes on Blurbs to add icon Support
  • 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
      • Multiple Choice Questions
      • Fill In The Blank Questions
    • Creating a Course or MOOC from a Markua Document
    • Question Alternates
  • Span Elements
    • Links
      • Inline Links
      • Automatic Links
    • Explicitly Creating Spans with []
      • Sometimes a Square Bracket is Just a Square Bracket
    • Footnotes and Endnotes
      • Footnotes
      • Endnotes
      • Single Reference to Footnotes and Endnotes
      • Footnotes and Endnotes Support Required for Paragraphs Only
    • Crosslinks and ids
      • Defining an id
      • Referencing an id With a Crosslink
      • Rules for ids and Crosslinks
    • Character Substitution (X-- for X—, X -- for X –, ... for …)
      • Optional Automatic Curly Quotes Outside of Code Blocks and Spans
    • Escaping Special Characters with Backslash (\)
    • Code Spans and Backticks (`)
  • Metadata
    • Attributes
      • Attribute List Format
      • Attribute Keys
      • Attribute Values
      • id Attributes
      • title Attributes
      • Conditional Inclusion Attributes on Headings: book, sample
    • Directives
  • Appendices
    • No Inline HTML
    • Differences with Markdown

Authors have earned$8,253,093writing, publishing and selling on Leanpub,
earning 80% royalties while saving up to 25 million pounds of CO2 and up to 46,000 trees.

Learn more about writing on Leanpub

The Leanpub 45-day 100% Happiness Guarantee

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

See full terms

Free Updates. Free App. 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), EPUB (for phones and tablets), MOBI (for Kindle) and in the free Leanpub App (for Mac, Windows, iOS and Android). 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. It really is that easy.

Learn more about writing on Leanpub