The Markua 0.30 Beta Manual

Don’t Read This Book (Yet)

Introduction

1. The Magical Typewriter
2. How to Write a Novel in Markua
3. How to Write a Computer Programming Book in Markua
4. How to Write a Course (MOOC) in Markua
5. Markua: Markdown for Books and Courses
6. Why the Name “Markua”?
7. The Markua Manual vs. The Markua Spec
8. Markua 0.10 and Markua 0.29
9. Differences with Leanpub Flavoured Markdown (LFM)
10. Acknowledgments

Text Formatting

Headings

Paragraphs and Blank Lines

Resources

1. Resource Insertion Methods
2. Figures
3. Spans
4. Inserting Resources Into a Span Context
5. Resource Locations
6. Local Resources
7. Web Resources
8. Inline Resources
9. Resource Types and Formats
10. Images
11. Video
12. Audio
13. Code
14. Math
15. Tables

Whitespace: Spaces, Tabs and Newlines

1. Newlines
2. Single Newline = Forced Line Break
3. Three or More Newlines = Two Newlines = One Blank Line
4. One Blank Line Is Added When Concatenating Manuscript Files
5. All Blank Lines at the Beginning and End of a File are Removed
6. Spaces and Tabs
7. Spaces and Tabs at the Beginning of a Line are Only to Determine List Containment, and Extra Spaces are Removed
8. Spaces and Tabs at the End of a Line are Removed
9. Internal Spaces are Collapsed to One Space, Except At the End of Sentences

Lists

Definition Lists

Block Elements

1. Scene Breaks (* * *)
2. Blockquotes (>)
3. Asides (A> or {aside})
4. Blurbs (B> or {blurb})
5. Supported Attributes for Blurbs
6. Syntactic Sugar for Specific Blurb Classes: D>, E>, I>, Q, T, W>, X>
7. Using Blurbs to Center Text with C>
8. Using Extension Attributes on Blurbs to add icon Support

Quizzes and Exercises

1. Quiz and Exercise Headings and Other Content
2. An Empty Quiz or Exercise is Not an Error
3. A Malformed Quiz or Exercise is an Error
4. Supported Attributes on Quizzes and/or Exercises
5. Question Types: Multiple Choice, Fill In The Blank
6. Multiple Choice Questions
7. Fill In The Blank Questions
8. Creating a Course or MOOC from a Markua Document
9. Question Alternates

Span Elements

1. Links
2. Inline Links
3. Automatic Links
4. Explicitly Creating Spans with […]
5. Sometimes a Square Bracket is Just a Square Bracket
6. Footnotes and Endnotes
7. Footnotes
8. Endnotes
9. Single Reference to Footnotes and Endnotes
10. Footnotes and Endnotes Support Required for Paragraphs Only
11. Crosslinks and ids
12. Defining an id
13. Referencing an id With a Crosslink
14. Rules for ids and Crosslinks
15. Character Substitution (X-- for X—, X -- for X –, ... for …)
16. Optional Automatic Curly Quotes Outside of Code Blocks and Spans
17. Escaping Special Characters with Backslash (\)
18. Code Spans and Backticks (`)

Metadata

1. Attributes
2. Attribute List Format
3. Attribute Keys
4. Attribute Values
5. id Attributes
6. Conditional Inclusion Attributes on Headings: book, sample
7. Directives
8. Page Breaks

Appendices

1. No Inline HTML
2. Differences with Markdown