pandoc is written in Haskell and may be a bit cumbersome to install.
#Markdown plus minus how to
Bonjour's tutorial provides many explanations on how to install and use pandoc in the Utilisation du convertisseur Pandoc section.
#Markdown plus minus software
To convert markdown in an "arbitrary" other format, the best solution today is Pandoc, a software developed by John MacFarlane, a philosopher from de Berkeley, and whose main page is on github. A few ones were mentioned in the beginning of the video and additional information are available in the "Quelques éditeurs adaptés à l'édition Markdown" section of Jean-Daniel Bonjour's tutorial. There are a few editors specifically designed for markdown (see for example the Editors page of the pandoc website) but we rather advise you to use a general-purpose editor that is capable of handling the markdown syntax. You may prefer to edit these documents with a real editor and later to export them in whichever format you may like ( html, pdf, docx, epub, etc). This is quite convenient but may be a bit cumbersome for a daily use. Github proposes a short and efficient introduction: Mastering Markdown.Īs we explain in the video, github and gitlab allow you to easily edit mardown documents and to render them in html.The wikipedia article on Markdown provides a good overview of the markdown syntax.
The « Élaboration et conversion de documents avec Markdown et Pandoc » tutorial by Jean-Daniel Bonjour (EPFL).Here are a few examples: This expression $\sum_x$įirst of all, to know more about markdown and its extensions, you may want to read: To write formulas using the displayed mode, they should be surrounded by a $$. To write formulas using the inline mode, they should be surrounded by a single $ (as a consequence, whenever you need to use the original dollar symbol, you should prefix it with a backslash: \$). The formatting generally slightly differs in both cases since, to display nicely on a single line, it is generally required to pack them a bit more than when they are emphasized. With the inline mode, formulas are inlined in the current paragraph whereas with the displayed mode, they appear as centered and emphasized. Math formulas are easy to write using Markdown, either using the inline mode or the displayed formulas mode. Inline code To print some text with python, you should use the `print()` function. Fractions, binomial coefficients, square roots, ….This document presents a brief overview of the Markdown syntax and builds on a presentation from the Github team and blog post from Archer Reilly.
Introduction to Markdown The source of this document is available on gitlab.
0 kommentar(er)
