> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/fr/articles-approfondis/32-markdown-into-latex-with-style.md). # Du Markdown vers LaTeX avec style **Mise à jour après publication** (13 mai 2017) : Nous sommes reconnaissants à Vít Novotný, l’auteur/mainteneur de `markdown` du paquet, pour nous avoir écrit avec des commentaires utiles concernant l’article original. Nous sommes heureux de publier cette version mise à jour qui tient compte de ses conseils et suggestions et les inclut. ### Introduction Il y a quelque temps, nous nous sommes réjouis de la sortie du [`paquet markdown`](http://www.ctan.org/pkg/markdown) qui a rendu possible l’écriture de syntaxe markdown dans des documents LaTeX — et nous l’avons célébré avec un article intitulé [Comment écrire en Markdown sur Overleaf](/latex/fr/articles-approfondis/30-how-to-write-in-markdown-on-overleaf.md) dont le but était de démontrer une partie de la syntaxe prise en charge. **Rappelez-vous** : Vous devrez compiler vos `.tex` fichiers avec l’ `--shell-escape` option pour que cela fonctionne sur les installations LaTeX locales — Overleaf le fait pour vous (automatiquement). Gardez à l’esprit que la plupart des portails de soumission de revues n’activent pas `--shell-escape` — à moins que vous ne soyez autorisé à téléverser uniquement le PDF de sortie de votre manuscrit, vos fichiers LaTeX contenant du markdown risquent de ne pas se compiler correctement lorsqu’ils sont traités par le système de soumission de l’éditeur. L’une des idées évoquées dans le [précédent article](/latex/fr/articles-approfondis/30-how-to-write-in-markdown-on-overleaf.md) est qu’une combinaison de markdown et de LaTeX permet une merveilleuse séparation du contenu et du style. Les auteurs (en particulier ceux déjà familiers avec markdown) disposeraient d’une syntaxe beaucoup plus concise à utiliser (avec quelques réserves), tout en conservant l’accès à toutes les merveilles des paquets et modèles LaTeX pour gérer la mise en forme et le formatage. Cela [précédent article](/latex/fr/articles-approfondis/30-how-to-write-in-markdown-on-overleaf.md) donnait quelques exemples d’utilisation de markdown dans [les présentations Beamer](https://www.overleaf.com/read/dnrwnjrpjjhw) et [les affiches](https://www.overleaf.com/read/jtbgmmgqrqmh) : aujourd’hui, nous allons examiner des possibilités de mise en forme encore plus amusantes et passionnantes ! ### Utiliser markdown dans des modèles LaTeX stylés Outre les exemples ci-dessus, vous pouvez utiliser markdown dans presque tous les modèles. Voici quelques exemples rapides : * Le [Livre orange de Legrange](https://www.overleaf.com/latex/templates/the-legrand-orange-book-template-english/jtctyfmnpppc) modèle * Le [polycopié inspiré de Tufte](https://www.overleaf.com/latex/templates/handout-design-inspired-by-edward-tufte/dtsbhhkvghzz) modèle * Ce [très joli modèle d’article](https://www.overleaf.com/read/xfsrpsmdtqvt) par Thiago Vous remarquerez peut-être que deux d’entre eux sont des modèles d’article et qu’un est un modèle de livre. Le [`paquet markdown`](http://www.ctan.org/pkg/markdown) détecte si la `\chapter` commande est disponible pour être utilisée dans un document LaTeX donné et fera que le titre de premier niveau `markdown` s’affiche sous forme de `\chapter` ou `\section` selon le cas. ### Polycopiés très rapides : markdown + PocketMod Dès que j’ai découvert markdown, cela m’a semblé être une façon rapide et pratique de prendre des notes : cela reflète la manière dont je pourrais griffonner des notes sur des bouts de papier ou des Post-it — surtout avec la syntaxe des listes à puces et numérotées. Lorsque j’ai créé pour la première fois le [modèle PocketMod](https://www.overleaf.com/read/nqbhpnrkskrx) en 2015, j’aspirais à un moyen d’écrire markdown en LaTeX afin de pouvoir créer des PocketMods *avec* markdown parce que cela semblait… approprié. Noter des idées dans une syntaxe simple sur de petits livrets pliés, mais avec une belle typographie — certaines personnes appellent les PocketMods des « zines » parce qu’il s’agit de petits livrets de 8 pages que l’on peut fabriquer à partir d’une seule feuille de papier A4. Et en effet, c’était possible ! Cela rend assez facile la production rapide d’un [mini-livret de planification hebdomadaire](https://www.overleaf.com/read/zfzcxygqwqsq) ou un petit [livre d’images racontant une histoire](https://www.overleaf.com/read/rppnsfgnrhsf). Oui, cela a amusé ma fille de voir un livre d’histoires fait à partir de ses propres dessins… enfin, pendant 10 minutes seulement ! Le [`paquet markdown`](http://www.ctan.org/pkg/markdown) vous permet de personnaliser la manière dont chaque syntaxe markdown est rendue en LaTeX, alors j’ai redéfini la syntaxe standard `![](img_file "légende")` de syntaxe pour placer la légende sous le fichier image (sans aucun préfixe « Figure » ni numérotation), puis j’ai inséré un saut de page. Cela facilite encore la création du livre d’images. Voici une vidéo montrant comment plier le livret : {% embed url="" %} ### Livrets de recettes simples Quand on y pense, une recette est composée de listes : une liste d’ingrédients, une liste d’instructions de préparation ou de cuisson, et peut-être une liste de notes (temps de cuisson, nombre de portions, etc.). Donc, plutôt que d’écrire ceci : ```latex \begin{enumerate} \item D’abord, faites ceci \item Puis faites cela ... \end{enumerate} ``` J’apprécierais certainement de pouvoir écrire ceci : ``` #. D’abord, faites ceci #. Puis faites cela ``` Et de même pour les ingrédients : ``` - 2 œufs - une pincée de sel ``` Ainsi, pour produire facilement une recette rapide, nous pouvons écrire ceci : ``` # Œufs brouillés Temps de cuisson : 5 minutes Pour : 1 ## Ingrédients - 4 œufs - 1 c. à café de beurre - 1/4 tasse de lait - sel, poivre (au goût) ## Instructions #. Battre les œufs, le lait... #. Faire chauffer le beurre dans la poêle... #. ... ``` Hmm, cela semble prometteur. Quelques-uns d’entre nous chez Overleaf (et nos familles) ont contribué avec leurs recettes rapides préférées (idéales pour les débutants en cuisine) et j’ai concocté — pardonnez le jeu de mots — un [modèle de recette rapide](https://www.overleaf.com/read/gscqdhnwzsfg) que vous pouvez écrire avec markdown *et* pour en faire un mini-livret. [![A recipe booklet produced on Overleaf using markdown](/files/2a88d6440fdff86da8b1ba9ee004e48f6cbbd7e7)](https://www.overleaf.com/read/gscqdhnwzsfg) Vient maintenant un autre petit plaisir. Sous le capot, c’est toujours du LaTeX, donc nous pouvons continuer à styliser les différents éléments — titres de section, listes à puces, polices, et ainsi de suite — en utilisant la boîte à outils habituelle de LaTeX. C’est là que je me suis un peu laissé emporter et que j’ai imaginé *trois* « thèmes » pour la `simple-recipe` classe ! ### Bonus 1 : Quelques réserves lors de l’utilisation du paquet markdown * SyncTeX ne fonctionnera pas tout à fait. Sur Overleaf, cela signifie que les opérations « position dans l’aperçu » et « cliquer dans l’aperçu pour accéder à la source » ne fonctionneront pas dans les `markdown` régions. * `\\\\` perd sa signification normale : le classique « deux espaces suivis d’une nouvelle ligne » `markdown` astuce ne fonctionne pas ici, car les espaces finaux seront supprimés par l’analyseur Lua, comme documenté dans le [`markdown` documentation du paquet](http://texdoc.net/pkg/markdown). `\\newline` fonctionnera en revanche. * Faites attention aux multiples caractères de soulignement sur la même ligne — cela peut poser problème si : * vous travaillez avec beaucoup d’indices dans vos équations (astuce : sortez du `markdown` environnement dans de tels cas) ; * vous aimez utiliser des soulignements dans vos clés BibTeX. Vous pouvez définir `underscores=false` avec les dernières `paquet markdown` fichiers pour que les soulignements d’indice fonctionnent, mais cela ne marchera toujours pas avec des soulignements dans les clés BibTeX. **Mise à jour** (13 mai 2017) : Les soulignements dans les clés BibTeX fonctionneront avec `markdown` la version v2.5.2 et suivantes — merci Vít ! * Vous aurez quelques difficultés à afficher un caractère dièse littéral, car même `\#` ne fonctionnera pas ! Je définis généralement une nouvelle commande et je l’utilise à la place. ### Bonus 2 : Nouvelles fonctionnalités dans la version mise à jour du paquet markdown `markdown` La version v2.4 et les suivantes ont ajouté la prise en charge de quelques syntaxes vraiment sympas : * **Syntaxe de note de bas de page intégrée**: `...^[c’est la note de bas de page]` (nécessite l’ `inlineFootnotes` option) * **Citations :**`[@smith1990]` (nécessite l’ `citations` option ; faites aussi attention aux soulignements dans vos clés BibTeX !) * **Bloc de code délimité** : Vous pouvez utiliser soit des tildes `~` ou des backticks `` ` `` comme délimiteur. ``` ~~~~ int main() { cout << "Bonjour le monde !"; return 0; } ~~~~ ``` Si vous souhaitez utiliser ces nouvelles fonctionnalités, veillez à téléverser des versions mises à jour de `markdown.lua`, `markdown.tex` et `markdown.sty` dans votre projet — ou vous pouvez simplement créer un nouveau projet à partir de [ce modèle](https://www.overleaf.com/read/whdrnpcpnwrm). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://overleaf-pro.ayaka.space/latex/fr/articles-approfondis/32-markdown-into-latex-with-style.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.