Discover how to write manuscripts in Markdown and translate them with Pandoc into different output formats. You’ll use Markdown to annotate text formatting information with a strong focus on semantic information: you can annotate your text with information about where chapters and sections start, but not how chapter and heading captions should be formatted. As a result, you’ll decouple the structure of a text from how it is visualized and make it easier for you to produce different kinds of output. The same text can easily be formatted as HTML, PDF, or Word documents, with various visual styles, by tools that understand the markup annotations.
Finally, you’ll learn to use Pandoc, a tool for translating between different markup languages, such as LaTeX, HTML, and Markdown. This book will not describe all the functionality that Pandoc provides, but will teach you how to translate Markdown documents, how to customize your documents using templates, and how to extend Pandoc’s functionality using filters. If that is something you are interested in, Introducing Markdown and Pandoc will get you started.
With this set of skills you’ll be able to write more efficiently without worrying about needless formatting and other distractions.
What You Will Learn
• Why and how to use Markdown and Pandoc
• Write Markdown
• Use extensions available in Pandoc and Markdown
• Write math and code blocks
• Use templates and produce documents
Who This Book Is For
Programmers and problem solvers looking for technical documentation solutions.
Author(s): Thomas Mailund
Edition: 1
Publisher: Apress
Year: 2019
Language: English
Commentary: True PDF
Pages: 139
City: New York, NY
Tags: Markdown; Pandoc; Documentation; LaTeX; Productivity; Metadata
Front Matter ....Pages i-ix
The Beginner’s Guide to Markdown and Pandoc (Thomas Mailund)....Pages 1-3
Why Use Markdown and Pandoc (Thomas Mailund)....Pages 5-12
Writing Markdown (Thomas Mailund)....Pages 13-22
Pandoc Markdown Extensions (Thomas Mailund)....Pages 23-34
Translating Documents (Thomas Mailund)....Pages 35-45
Math and Computer Programming Languages (Thomas Mailund)....Pages 47-55
Cross-referencing (Thomas Mailund)....Pages 57-66
Metadata (Thomas Mailund)....Pages 67-71
Using Templates (Thomas Mailund)....Pages 73-89
Preprocessing (Thomas Mailund)....Pages 91-98
Filters (Thomas Mailund)....Pages 99-131
Conclusions (Thomas Mailund)....Pages 133-133
Back Matter ....Pages 135-139