basic_setup
-
Learn Markdown in 3 Minutes
Markdown syntax is extremely simple and you can learn all you need to know within a few minutes.
-
Tools to Support Your Markdown Authoring
Markdown is automatically rendered to html GitHub but can easily be parsed into a variety of other formats including PDF and LaTex. To convert seamlessly to these formats, you’ll need a document converter. Pandoc is one such open source tool that is available on all platforms. You’ll need to install a local copy to be able to run all the examples in this repo.
markdown_elements
-
Citations
Citations breakout group at Markdown for Science workshop Citations should be specified as citation keys (e.g. (???). Pandoc and Multimarkdown both support human-readable formatting for this, but use different formatting.
-
Math
MathML the “HTML for math” The web (HTML5), ebook (epub3) and publishing (XML) standard for mathematical equations is MathML. Just like HTML, MathML can be highly verbose, so manual input is usually done using other tools. In particular, there are several serial math input formats (see below).
advanced_formatting
-
Extending Markdown
Markdown is a lightweight format that does not offer built-in facilities for extension. Instead it is recommended to combine external templating tools to adapt the syntax to particular use cases, where necessary. To avoid an unnecessary inflation in the number of markdown flavors out there, it is recommended that language extensions are used sparingly.
workshop
-
Workshop June 2013
Martin Fenner and Stian Haklev organized a one day Markdown for Science workshop at the Public Library of Science HQ in San Francisco on June 8th, 2013.