Scene 1 · Literate programming & markdown
We learn the structure and elements of a Markdown document
We introduce practical uses of Markdown for research
We introduce practical uses of Markdown for teaching
[Estimated time: 2 hours]
Markdown is a very simple language for writing content especially for the web. This interactive tutorial markdowntutorial is a good starting point to learn the basics of Markdown.
This presentation “Markdown: uses for research and teaching” (slides) summarises its advantages and provides some practical uses for research and teaching. It also includes a demo to generate different output formats (HTML, PDF, etc) from the same document in Markdown. The important thing is not the tool used, but that you think about the possibilities that Markdown can offer you to speed up the management of documents in different formats.
If you see mistakes or want to suggest changes, please create an issue on the source repository.
Text and figures are licensed under Creative Commons Attribution CC BY-NC-SA 4.0. Source code is available at https://github.com/cgranell/rrp-uji, unless otherwise noted. The figures that have been reused from other sources don't fall under this license and can be recognized by a note in their caption: "Figure from ...".