--- ###### tags: `epfl` --- # Markdown À l'heure de l'apéro, mars 2017 *Raphaël Grolimund* Bibliothèque de l'EPFL   --- ## Avant de commencer... Rendez-vous sur [menti.com](https://www.menti.com/) et tapez le code! --- ## Qu'est-ce que c'est ? **Markdown**, c'est 1. un langage de balisage (très) léger, facile à écrire et facile à lire. 2. un logiciel libre (sous licence BSD) très léger (18Ko) de conversion de texte en HTML *version actuelle*: v1.0.1 (décembre 2004) *extension des fichiers*: .md ou .markdown. ---- ## Pourquoi Markdown | outil | balisage | lisibilité | *versioning* | | :---- | :------: | :--------: |:-----------: | | LaTeX | lourd | LaTeX seulement | facile | | Markdown | léger | n'importe quel logiciel | facile | | Word/Writer | interface graphique | traitement de texte seulement | horrible | ---- ## Origine Créé par **John Gruber** [daringfireball.net](daringfireball.net) avec l'aide d'**Aaron Swartz** --- ## Syntaxe de base `# titre 1` `## titre 2` etc. `**gras**` **gras** `*italique*` *italique* `[texte](url)` [texte](url) `[id]` <- appel de note de bas de page / de fin ``  `[id]: note de bas de page / de fin` ---- ## Syntaxe de base (suite) liste numérotée 1. premier 2. deuxième 3. etc. liste à puces * entrée a * entrée b * etc. ---- ## Syntaxes avancées Github *flavored* ajoute la possibilité de créer des tableaux `| entrée | valeur |` `| :----- | :----: |` `| A | 96 |` `| B | 102 |` --- ## Outils de base | type | outil | lien | | :--- | :---- | :--- | | éditeur en ligne | Dillinger | [http://dillinger.io](http://dillinger.io) | | logiciel installé | Atom | [https://atom.io](https://atom.io) | | e-mail | Markdown Here | [http://markdown-here.com](http://markdown-here.com) | ---- ## Outils collaboratifs | type | outil | lien | | :--- | :---- | :--- | | prise de notes collaborative | Etherpad | [https://framapad.org/](https://framapad.org/) p. ex. | | Documentation | Gitbook | [https://gitbook.com](https://gitbook.com) | | CMS (web) | Ghost | [https://ghost.org](https://ghost.org) | *Le support de [Ma vie sans Google](https://www.gitbook.com/book/grolimur/ma-vie-sans-google/details) a été écrit en Markdown et mis en ligne sur Gitbook* ---- ## Outils scientifiques | type | outil | lien | | :--- | :---- | :--- | | écriture scientifique | Authorea | [https://authorea.com](https://authorea.com) | | citation | Zotero Picker | [https://atom.io/packages/zotero-picker](https://atom.io/packages/zotero-picker) | | stats | RMarkdown | [http://rmarkdown.rstudio.com](http://rmarkdown.rstudio.com) | ---- ## Plus d'outils Markdown peut être utilisé dans bien d'autres logiciels parmi lesquels... | type | outil | lien | | :--- | :---- | :--- | | gestion des favoris | Shaarli | [https://github.com/shaarli/Shaarli](https://github.com/shaarli/Shaarli) | | gestion des mots de passe | Turtl | [https://www.turtl.io](https://www.turtl.io) | | communication (interne) collaborative | Mattermost | [https://framateam.org](https://framateam.org) p. ex. | | présentation | HackMD | [https://hackmd.io](https://hackmd.io) | *Note: Cette présentation a été rédigée en Markdown.* --- ## TP À vous maintenant de tester Markdown en utilisant [Dillinger.io](http://dillinger.io) ! --- ## Ressources BORBOEN, Nicolas, 2013. Markdown.*Flash Informatique*. 2013. N° 1, pp. 5‑8. [http://flashinformatique.epfl.ch/IMG/pdf/fi-1-13.pdf](http://flashinformatique.epfl.ch/IMG/pdf/fi-1-13.pdf) Github, 2014. Mastering Markdown. *Github*. [guides.github.com/features/mastering-markdown/](https://guides.github.com/features/mastering-markdown/) Gruber, John, 2004. Markdown: Syntax. *Daring Fireball* [http://daringfireball.net/projects/markdown/syntax](http://daringfireball.net/projects/markdown/syntax) Pritchard, Adam, 2016. Markdown Cheatsheet. *Github*. [https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) --- ## À propos Ce document est publié sous licence **CC BY**  Dernière mise à jour effectuée le **13 mars 2017**