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
Who This Book Is For
- 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
Programmers and problem solvers looking for technical documentation solutions.
Thomas Mailund is an associate professor in bioinformatics at Aarhus University, Denmark. He has a background in math and computer science, including experience programming and teaching in the C and R programming languages. For the last decade, his main focus has been on genetics and evolutionary studies, particularly comparative genomics, speciation, and gene flow between emerging species.
1: The Beginner's Guide to Markdown and Pandoc2: Why Use Markdown and Pandoc3: Writing Markdown4: Pandoc Markdown Extensions5: Translating Documents6: Math and Computer Programming Languages7: Cross-referencing8: Metadata9: Using Templates10: Preprocessing11: Filters12: Conclusions