convert content to md

4 files changed, 88 insertions, 121 deletions

diff --git a/files/fr/mdn/contribute/howto/convert_code_samples_to_be_live/index.md b/files/fr/mdn/contribute/howto/convert_code_samples_to_be_live/index.md
index 5575715390..4ef023d508 100644
--- a/files/fr/mdn/contribute/howto/convert_code_samples_to_be_live/index.md
+++ b/files/fr/mdn/contribute/howto/convert_code_samples_to_be_live/index.md
@@ -4,24 +4,21 @@ slug: MDN/Contribute/Howto/Convert_code_samples_to_be_live
 translation_of: MDN/Contribute/Howto/Convert_code_samples_to_be_live
 original_slug: MDN/Contribute/Howto/convertir_code_pour_etre_direct
 ---
-<div>{{MDNSidebar}}</div>
-<p>MDN dispose d'un système d'exemples "<a href="/en-US/docs/MDN/Contribute/Editor/Live_samples">live</a>", grâce auxquels le code présent sur une page est exécuté pour afficher les résultats de l'exécution de ce code. Cependant, beaucoup d'articles existants affichent du code sans utiliser ce système, et ont donc besoin d'être convertis.</p>
+{{MDNSidebar}}
 
-<p>Les exemples "live", vous permettent de voir à quoi ressemble le résultat d'un exemple, faire une documentation plus dynamique et instructive. Ce guide vous explique comment prendre des exemples existants et leur rajouter la fonctionnalité "live".</p>
+MDN dispose d'un système d'exemples "[live](/en-US/docs/MDN/Contribute/Editor/Live_samples)", grâce auxquels le code présent sur une page est exécuté pour afficher les résultats de l'exécution de ce code. Cependant, beaucoup d'articles existants affichent du code sans utiliser ce système, et ont donc besoin d'être convertis.
 
-<h2>Compétences nécessaires pour cette tâche</h2>
+Les exemples "live", vous permettent de voir à quoi ressemble le résultat d'un exemple, faire une documentation plus dynamique et instructive. Ce guide vous explique comment prendre des exemples existants et leur rajouter la fonctionnalité "live".
 
-<ul>
-  <li>Comprendre le HTML, CSS et/ou JavaScript, selon le code implémenté</li>
-  <li>Savoir utiliser les macros <a href="/en-US/docs/Project:Introduction_to_KumaScript">KumaScript</a> dans les articles du MDN</li>
- </ul>
+## Compétences nécessaires pour cette tâche
 
-<h2>Quelles étapes pour réaliser cette tâche ?</h2>
+- Comprendre le HTML, CSS et/ou JavaScript, selon le code implémenté
+- Savoir utiliser les macros [KumaScript](/en-US/docs/Project:Introduction_to_KumaScript) dans les articles du MDN
 
-<ol>
-  <li>Choisissez un article dans la liste de ceux marqués <a href="/en-US/docs/tag/NeedsLiveSample">NeedsLiveSample</a>, pour lequel le code présenté porte sur des notions qui vous sembles familières.</li>
-  <li>Convertissez le code pour qu'il soit "live"</li>
-  <li>Supprimer le code ou l'image qui montrait les sorties et résultats du programme. Votre exemple "live" le remplace désormais.</li>
-</ol>
+## Quelles étapes pour réaliser cette tâche ?
 
-<p>Pour plus d'information sur la création et l'édition d'exemples "live", voir <a href="/en-US/docs/Project:MDN/Contributing/Editor_guide/Live_samples">Utiliser le système d'exemple "live"</a> (en anglais).</p>
+1.  Choisissez un article dans la liste de ceux marqués [NeedsLiveSample](/en-US/docs/tag/NeedsLiveSample), pour lequel le code présenté porte sur des notions qui vous sembles familières.
+2.  Convertissez le code pour qu'il soit "live"
+3.  Supprimer le code ou l'image qui montrait les sorties et résultats du programme. Votre exemple "live" le remplace désormais.
+
+Pour plus d'information sur la création et l'édition d'exemples "live", voir [Utiliser le système d'exemple "live"](/en-US/docs/Project:MDN/Contributing/Editor_guide/Live_samples) (en anglais).
diff --git a/files/fr/mdn/contribute/howto/create_and_edit_pages/index.md b/files/fr/mdn/contribute/howto/create_and_edit_pages/index.md
index 70cb353739..68fc903f39 100644
--- a/files/fr/mdn/contribute/howto/create_and_edit_pages/index.md
+++ b/files/fr/mdn/contribute/howto/create_and_edit_pages/index.md
@@ -1,44 +1,47 @@
 ---
 title: Créer et modifier des pages
 slug: MDN/Contribute/Howto/Create_and_edit_pages
-translation_of: 'MDN/Contribute/Howto/Create_and_edit_pages'
+translation_of: MDN/Contribute/Howto/Create_and_edit_pages
 ---
-<div>{{MDNSidebar}}</div>
+{{MDNSidebar}}
 
-<p>Cet article est destiné à présenter aux personnes souhaitant contribuer à MDN le processus de modification de pages existantes et de création de nouvelles pages.</p>
+Cet article est destiné à présenter aux personnes souhaitant contribuer à MDN le processus de modification de pages existantes et de création de nouvelles pages.
 
-<div class="note">
-  <p><strong>Note :</strong> Le contenu de MDN s'organise au sein de deux dépôts Git : <a href="https://github.com/mdn/content"><code>mdn/content</code></a> avec le contenu en anglais et <a href="https://github.com/mdn/translated-content"><code>mdn/translated-content</code></a> avec le contenu traduit (y compris en français). C'est le dépôt <code>mdn/content</code> qui constitue la référence. Si vous souhaitez créer une page en français, celle-ci devra au préalable avoir été créée en anglais.</p>
-</div>
-<h2 id="editing_an_existing_page">Modifier une page existante</h2>
+> **Note :** Le contenu de MDN s'organise au sein de deux dépôts Git : [`mdn/content`](https://github.com/mdn/content) avec le contenu en anglais et [`mdn/translated-content`](https://github.com/mdn/translated-content) avec le contenu traduit (y compris en français). C'est le dépôt `mdn/content` qui constitue la référence. Si vous souhaitez créer une page en français, celle-ci devra au préalable avoir été créée en anglais.
 
-<p>Pour modifier une page, vous devez trouver la page source :</p>
-<ul>
-  <li>Si elle est en anglais : <a href="https://github.com/mdn/content">sur notre dépôt <i lang="en">content</i></a></li>
-  <li>Si elle est en français ou dans une autre langue : <a href="https://github.com/mdn/translated-content">sur notre dépôt <i lang="en">translated-content</i></a></li>
-</ul>.
-<p>La façon la plus rapide de la trouver est d'aller sur la page que vous souhaitez modifier, puis de vous rendre en bas de cette page et enfin de cliquer sur le lien <i lang="en">«&nbsp;Source on GitHub&nbsp;»</i>.</p>
+## Modifier une page existante
 
-<p>Une fois que vous avez trouvé la source à modifier, rendez-vous sur notre fichier <i lang="en">README</i> et parcourez notre <a href="https://github.com/mdn/translated-content/#making-contributions">guide sur la contribution (en anglais)</a>. Vous pouvez également consulter <a href="https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer">ce billet en français</a> pour savoir comment contribuer.</p>
+Pour modifier une page, vous devez trouver la page source :
 
-<h3 id="preview_changes">Prévisualiser vos modifications</h3>
+- Si elle est en anglais : [sur notre dépôt <i lang="en">content</i>](https://github.com/mdn/content)
 
-<p>SI vous modifiez la page en local, vous pouvez voir à quoi ressembleront vos modifications en allant sur le dossier du dépôt nommé <i lang="en">content</i>, en exécutant la commande CLI <code>yarn start</code>, puis en vous rendant à l'URL <code>localhost:5000</code> dans votre navigateur, et enfin en retrouvant la page sur laquelle vous travaillez. Pour la trouver plus facilement, utilisez la boîte de recherche. La page que vous prévisualisez sera rafraîchie automatiquement au fur et à mesure que vous modifiez son code source.</p>
+  <i lang="en">content</i>
 
-<h3 id="attach_files">Ajouter des pièces jointes</h3>
+- Si elle est en français ou dans une autre langue : [sur notre dépôt <i lang="en">translated-content</i>](https://github.com/mdn/translated-content)
 
-<p>Pour ajouter un fichier en pièce jointe à votre article, vous avez simplement besoin de l'inclure dans le même répertoire du fichier <code>index.html</code> de votre article, puis de l'ajouter dans votre page, typiquement à l'aide d'un élément <code>&lt;a&gt;</code>.</p>
+  <i lang="en">translated-content</i>
 
-<h2 id="creating_a_new_page">Créer une nouvelle page</h2>
+.
 
-<p>Pour créer une nouvelle page, consultez les instructions fournies sur la <a href="https://github.com/mdn/content#adding-a-new-document">documentation concernant l'ajout de nouveaux documents (en anglais)</a>.</p>
+La façon la plus rapide de la trouver est d'aller sur la page que vous souhaitez modifier, puis de vous rendre en bas de cette page et enfin de cliquer sur le lien <i lang="en">« Source on GitHub »</i>.
 
-<div class="warning">
-  <p><strong>Attention :</strong> Pour créer une page en français (ou dans une autre langue), celle-ci devra préalablement exister/avoir été créée en anglais.</p>
-</div>
-<h2 id="see_also">Voir aussi</h2>
+Une fois que vous avez trouvé la source à modifier, rendez-vous sur notre fichier <i lang="en">README</i> et parcourez notre [guide sur la contribution (en anglais)](https://github.com/mdn/translated-content/#making-contributions). Vous pouvez également consulter [ce billet en français](https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer) pour savoir comment contribuer.
 
-<ul>
-  <li><a href="/fr/docs/MDN/Guidelines/Writing_style_guide">Guide stylistique de MDN</a></li>
-  <li><a href="https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer">MDN sur GitHub&nbsp;: comment contribuer&nbsp;?</a></li>
-</ul>
+### Prévisualiser vos modifications
+
+SI vous modifiez la page en local, vous pouvez voir à quoi ressembleront vos modifications en allant sur le dossier du dépôt nommé <i lang="en">content</i>, en exécutant la commande CLI `yarn start`, puis en vous rendant à l'URL `localhost:5000` dans votre navigateur, et enfin en retrouvant la page sur laquelle vous travaillez. Pour la trouver plus facilement, utilisez la boîte de recherche. La page que vous prévisualisez sera rafraîchie automatiquement au fur et à mesure que vous modifiez son code source.
+
+### Ajouter des pièces jointes
+
+Pour ajouter un fichier en pièce jointe à votre article, vous avez simplement besoin de l'inclure dans le même répertoire du fichier `index.html` de votre article, puis de l'ajouter dans votre page, typiquement à l'aide d'un élément `<a>`.
+
+## Créer une nouvelle page
+
+Pour créer une nouvelle page, consultez les instructions fournies sur la [documentation concernant l'ajout de nouveaux documents (en anglais)](https://github.com/mdn/content#adding-a-new-document).
+
+> **Attention :** Pour créer une page en français (ou dans une autre langue), celle-ci devra préalablement exister/avoir été créée en anglais.
+
+## Voir aussi
+
+- [Guide stylistique de MDN](/fr/docs/MDN/Guidelines/Writing_style_guide)
+- [MDN sur GitHub : comment contribuer ?](https://tech.mozfr.org/post/2021/03/16/MDN-sur-GitHub-comment-contribuer)
diff --git a/files/fr/mdn/contribute/howto/index.md b/files/fr/mdn/contribute/howto/index.md
index 59b33bbba6..77a41256ec 100644
--- a/files/fr/mdn/contribute/howto/index.md
+++ b/files/fr/mdn/contribute/howto/index.md
@@ -6,8 +6,8 @@ tags:
   - MDN Meta
 translation_of: MDN/Contribute/Howto
 ---
-<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/fr/docs/MDN")}}</div>
+{{MDNSidebar}}{{IncludeSubnav("/fr/docs/MDN")}}
 
-<p>Ces articles fournissent des guides pas-à-pas pour la réalisation d'objectifs spécifiques lorsque vous contribuez sur MDN.</p>
+Ces articles fournissent des guides pas-à-pas pour la réalisation d'objectifs spécifiques lorsque vous contribuez sur MDN.
 
-<p>{{LandingPageListSubpages}}</p>
+{{LandingPageListSubpages}}
diff --git a/files/fr/mdn/contribute/howto/write_a_new_entry_in_the_glossary/index.md b/files/fr/mdn/contribute/howto/write_a_new_entry_in_the_glossary/index.md
index b70818e6d9..d518794b83 100644
--- a/files/fr/mdn/contribute/howto/write_a_new_entry_in_the_glossary/index.md
+++ b/files/fr/mdn/contribute/howto/write_a_new_entry_in_the_glossary/index.md
@@ -8,105 +8,72 @@ tags:
   - MDN Méta(2)
 translation_of: MDN/Contribute/Howto/Write_a_new_entry_in_the_Glossary
 ---
-<div>{{MDNSidebar}}</div>
+{{MDNSidebar}}
 
-<p>Le <a href="/fr/docs/Glossary">glossaire</a> MDN est le lieu privilégié où nous définissons la terminologie, le jargon et les abréviations utilisés dans la documentation et les codes.  Contribuer à ce glossaire est une moyen simple de rendre le Web plus compréhensible pour n'importe qui. Nul besoin de posséder un haut niveau de compétence pour écrire des entrées du glossaire,  elles doivent rester simples et évidentes.</p>
+Le [glossaire](/fr/docs/Glossary) MDN est le lieu privilégié où nous définissons la terminologie, le jargon et les abréviations utilisés dans la documentation et les codes.  Contribuer à ce glossaire est une moyen simple de rendre le Web plus compréhensible pour n'importe qui. Nul besoin de posséder un haut niveau de compétence pour écrire des entrées du glossaire,  elles doivent rester simples et évidentes.
 
-<h2 id="Comment_créer_une_entrée">Comment créer une entrée</h2>
+## Comment créer une entrée
 
-<p>Pour trouver des sujets ayant besoin d'entrées de glossaire, consultez la <a href="/fr/docs/Glossary#Contribute_to_the_glossary">liste des termes à documenter </a>à la fin de la page concernant le sujet en question ; cliquez n'importe lequel de ses liens pour commencer une nouvelle page de glossaire, puis suivez les étapes ci-dessous.</p>
+Pour trouver des sujets ayant besoin d'entrées de glossaire, consultez la [liste des termes à documenter ](/fr/docs/Glossary#Contribute_to_the_glossary)à la fin de la page concernant le sujet en question ; cliquez n'importe lequel de ses liens pour commencer une nouvelle page de glossaire, puis suivez les étapes ci-dessous.
 
-<h3 id="Étape_1_écrire_un_résumé">Étape 1: écrire un résumé</h3>
+### Étape 1: écrire un résumé
 
-<p>Le premier paragraphe d'une page de glossaire consiste en une description courte et simple du terme — de préférence n'exédant pas les deux lignes. Assurez-vous que n'importe qui lisant cette description puisse immédiatement saisir le sens du terme concerné.</p>
+Le premier paragraphe d'une page de glossaire consiste en une description courte et simple du terme — de préférence n'exédant pas les deux lignes. Assurez-vous que n'importe qui lisant cette description puisse immédiatement saisir le sens du terme concerné.
 
-<div class="note">
-<p><strong>Note :</strong> ne copiez-collez pas la définition d'un autre endroit (spécialement pas de Wikipédia, puisque leurs licences sont réduites et donc incompatiles avec celles de MDN).</p>
-</div>
+> **Note :** ne copiez-collez pas la définition d'un autre endroit (spécialement pas de Wikipédia, puisque leurs licences sont réduites et donc incompatiles avec celles de MDN).
 
-<div class="note">
-<p><strong>Note :</strong> il est important également de s'assurer que le contenu est simple et compréhensible. Cela vaut la peine de passer un peu de temps dessus plutôt que de trahir le sens. Ce glossaire doit contenir du contenu nouveau et utile, pas répéter ce que l'on peut trouver partout ailleurs.</p>
-</div>
+> **Note :** il est important également de s'assurer que le contenu est simple et compréhensible. Cela vaut la peine de passer un peu de temps dessus plutôt que de trahir le sens. Ce glossaire doit contenir du contenu nouveau et utile, pas répéter ce que l'on peut trouver partout ailleurs.
 
-<p>Les liens conduisant à cette entrée de glossaire feront apparaitre ce résumé au survol de la souris, de telle sorte que le lecteur pourra obtenir une définition sans avoir à naviguer jusqu'à la page concernée (voyez ci-dessous comment insérer un lien vers une entrée de glossaire avec la macro \{{Glossary}}).</p>
+Les liens conduisant à cette entrée de glossaire feront apparaitre ce résumé au survol de la souris, de telle sorte que le lecteur pourra obtenir une définition sans avoir à naviguer jusqu'à la page concernée (voyez ci-dessous comment insérer un lien vers une entrée de glossaire avec la macro \\{{Glossary}}).
 
-<p>Si vous y tenez, vous pouvez ajouter quelques paragraphes supplémentaires, mais prenez garde de ne pas vous retrouver à écrire tout un article. Écrire un article complet est une bonne chose, mais ne le placez pas dans le glossaire. Si vous ne savez pas où placer cet article, n'hésitez pas à <a href="/fr/docs/MDN/Community#Join_our_mailing_lists">prendre la parole pour en parler ici</a>.</p>
+Si vous y tenez, vous pouvez ajouter quelques paragraphes supplémentaires, mais prenez garde de ne pas vous retrouver à écrire tout un article. Écrire un article complet est une bonne chose, mais ne le placez pas dans le glossaire. Si vous ne savez pas où placer cet article, n'hésitez pas à [prendre la parole pour en parler ici](/fr/docs/MDN/Community#Join_our_mailing_lists).
 
-<h3 id="Étape_2_offrir_d'autres_sources">Étape 2 : offrir d'autres sources</h3>
+### Étape 2 : offrir d'autres sources
 
-<p>Pour terminer, une entrée de glossaire devrait toujours s'achever sur une section « En savoir plus ». Cette section devrait contenir des liens qui aideront le lecteur à aller plus loin : découvrir le sujet plus en détail, apprendre à utiliser la technologie en question, etc.</p>
+Pour terminer, une entrée de glossaire devrait toujours s'achever sur une section « En savoir plus ». Cette section devrait contenir des liens qui aideront le lecteur à aller plus loin : découvrir le sujet plus en détail, apprendre à utiliser la technologie en question, etc.
 
-<p>Il est recommandé de trier ces liens en au moins trois groupes :</p>
+Il est recommandé de trier ces liens en au moins trois groupes :
 
-<dl>
- <dt>Connaissance générale</dt>
- <dd>Liens qui fournissent plus d'information générale ; par exemple, un lien vers <a href="http://fr.wikipedia.org/">Wikipédia</a> est un excellent début.</dd>
- <dt>Références techniques</dt>
- <dd>Liens vers une information technique plus avancée, sur MDN par exemple.</dd>
- <dt>Apprentissage et tutoriels</dt>
- <dd>Liens vers des tutoriels, des exercices ou tout autre matériel susceptible d'apprendre au lecteur à maitriser les technologies liées au terme défini.</dd>
-</dl>
+- Connaissance générale
+  - : Liens qui fournissent plus d'information générale ; par exemple, un lien vers [Wikipédia](http://fr.wikipedia.org/) est un excellent début.
+- Références techniques
+  - : Liens vers une information technique plus avancée, sur MDN par exemple.
+- Apprentissage et tutoriels
+  - : Liens vers des tutoriels, des exercices ou tout autre matériel susceptible d'apprendre au lecteur à maitriser les technologies liées au terme défini.
 
-<h2 id="Termes_suggérés">Termes suggérés</h2>
+## Termes suggérés
 
-<p>Vous désirez contribuer mais vous ignorez quel terme doit être défini ? <a href="https://developer.mozilla.org/fr/docs/Glossary#Contribute_to_the_glossary">Voici une liste</a> de suggestions. Cliquez un mot et lancez-vous !</p>
+Vous désirez contribuer mais vous ignorez quel terme doit être défini ? [Voici une liste](https://developer.mozilla.org/fr/docs/Glossary#Contribute_to_the_glossary) de suggestions. Cliquez un mot et lancez-vous !
 
-<h2 id="Gérer_les_ambiguïtés">Gérer les ambiguïtés</h2>
+## Gérer les ambiguïtés
 
-<p>Parfois, en fonction du contexte, un même terme peut connaitre plusieurs définitions. Pour traiter ces ambiguïtés, vous devez suivre ce guide :</p>
+Parfois, en fonction du contexte, un même terme peut connaitre plusieurs définitions. Pour traiter ces ambiguïtés, vous devez suivre ce guide :
 
-<ul>
- <li>La page principale du terme doit être une page de « désambiguïsation » contenant la macro {{TemplateLink("GlossaryDisambiguation")}}.</li>
- <li>Des sous-pages définissent ensuite le terme dans chacun de ses contextes propres.</li>
-</ul>
+- La page principale du terme doit être une page de « désambiguïsation » contenant la macro {{TemplateLink("GlossaryDisambiguation")}}.
+- Des sous-pages définissent ensuite le terme dans chacun de ses contextes propres.
 
-<p>Illustrons cela par un exemple. Le terme <em>signature</em> peut avoir différentes significations dans au moins trois contextes différents : la <em>sécurité</em>, les <em>fonctions</em> et les <em>mèls</em>.</p>
+Illustrons cela par un exemple. Le terme _signature_ peut avoir différentes significations dans au moins trois contextes différents : la _sécurité_, les _fonctions_ et les _mèls_.
 
-<ol>
- <li>La page <a href="/fr/docs/Glossary/Signature">Glossaire/Signature</a> est la page de « désambiguïsation » avec la macro {{TemplateLink("GlossaryDisambiguation")}} macro.</li>
- <li>La sous-page <a href="/fr/docs/Glossary/Signature/Security">Glossaire/Signature/Sécurité</a> est la page définissant le terme dans le contexte de la sécurité informatique.</li>
- <li>La sous-page <a href="/fr/docs/Glossary/Signature/Function">Glossaire/Signature/Fonction</a> est la page définissant les <em>signatures de fonction</em>.</li>
- <li>La sous-page <a href="/en-US/docs/Glossary/Signature/Email">Glossaire/Signature/Mèl</a> est la page définissant les signatures de mèl.</li>
-</ol>
+1.  La page [Glossaire/Signature](/fr/docs/Glossary/Signature) est la page de « désambiguïsation » avec la macro {{TemplateLink("GlossaryDisambiguation")}} macro.
+2.  La sous-page [Glossaire/Signature/Sécurité](/fr/docs/Glossary/Signature/Security) est la page définissant le terme dans le contexte de la sécurité informatique.
+3.  La sous-page [Glossaire/Signature/Fonction](/fr/docs/Glossary/Signature/Function) est la page définissant les _signatures de fonction_.
+4.  La sous-page [Glossaire/Signature/Mèl](/en-US/docs/Glossary/Signature/Email) est la page définissant les signatures de mèl.
 
-<h2 id="Utiliser_la_macro_Glossary">Utiliser la macro \{{Glossary}}</h2>
+## Utiliser la macro \\{{Glossary}}
 
-<p>Le glossaire devient beaucoup plus utile lorsque le lecteur peut atteindre les définitions depuis un autre document sans avoir à  naviguer hors de ce document. C'est la raison pour laquelle nous vous incitons à créer des liens vers le glossaire dès que vous le pouvez, en utilisant la macro {{TemplateLink("Glossary")}} :</p>
+Le glossaire devient beaucoup plus utile lorsque le lecteur peut atteindre les définitions depuis un autre document sans avoir à  naviguer hors de ce document. C'est la raison pour laquelle nous vous incitons à créer des liens vers le glossaire dès que vous le pouvez, en utilisant la macro {{TemplateLink("Glossary")}} :
 
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">Macro</th>
-   <th scope="col">Result</th>
-   <th scope="col">Note</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>\{{Glossary("browser")}}</td>
-   <td>{{Glossary("browser")}}</td>
-   <td>Quand un terme correspond à un terme à définir, utilisez simplement la macro telle quelle (notez qu'elle est sensible à la casse — minuscule/majuscule)</td>
-  </tr>
-  <tr>
-   <td>\{{Glossary("browser", "Web browser")}}</td>
-   <td>{{Glossary("browser","Web browser")}}</td>
-   <td>Fournissez en deuxième argument un texte alternatif à afficher.</td>
-  </tr>
-  <tr>
-   <td>\{{Glossary("browser", "Web browser", 1)}}</td>
-   <td>{{Glossary("browser","Web browser",1)}}</td>
-   <td>Optionnellement, entrez le chiffre<code> 1</code> comme troisième argument pour afficher le lien de façon classique plutôt que comme une mise en exergue subtile.</td>
-  </tr>
- </tbody>
-</table>
+| Macro                                                      | Result                                               | Note                                                                                                                                                    |
+| ---------------------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| \\{{Glossary("browser")}}                         | {{Glossary("browser")}}                     | Quand un terme correspond à un terme à définir, utilisez simplement la macro telle quelle (notez qu'elle est sensible à la casse — minuscule/majuscule) |
+| \\{{Glossary("browser", "Web browser")}}     | {{Glossary("browser","Web browser")}}     | Fournissez en deuxième argument un texte alternatif à afficher.                                                                                         |
+| \\{{Glossary("browser", "Web browser", 1)}} | {{Glossary("browser","Web browser",1)}} | Optionnellement, entrez le chiffre` 1` comme troisième argument pour afficher le lien de façon classique plutôt que comme une mise en exergue subtile.  |
 
-<p>Les liens créés avec la macro \{{Glossary}} affichent toujours un texte au survol de la souris, qui contient le résumé de l'entrée du glossaire (cf. ci-dessus).</p>
+Les liens créés avec la macro \\{{Glossary}} affichent toujours un texte au survol de la souris, qui contient le résumé de l'entrée du glossaire (cf. ci-dessus).
 
-<h3 id="Conventions">Conventions</h3>
+### Conventions
 
-<p>Dans la plupart des cas, sur MDN, l'usage de la macro est sûr. Il y a cependant quelques exceptions que vous devez aborder avec précaution :</p>
+Dans la plupart des cas, sur MDN, l'usage de la macro est sûr. Il y a cependant quelques exceptions que vous devez aborder avec précaution :
 
-<ul>
- <li>Si un terme est déjà lié à une autre partie de MDN, n'y touchez pas et n'utilisez pas la macro \{{Glossary}}.</li>
- <li>À l'intérieur d'une même section d'article, n'utilisez la macro \{{Glossary}} qu'une seule fois pour le même terme (<em>astuce : une section commence toujours par un titre</em>).</li>
-</ul>
+- Si un terme est déjà lié à une autre partie de MDN, n'y touchez pas et n'utilisez pas la macro \\{{Glossary}}.
+- À l'intérieur d'une même section d'article, n'utilisez la macro \\{{Glossary}} qu'une seule fois pour le même terme (_astuce : une section commence toujours par un titre_).