convert content to md

1 files changed, 38 insertions, 57 deletions

diff --git a/files/fr/web/api/permissions_api/index.md b/files/fr/web/api/permissions_api/index.md
index 3d0d7e9214..92c2e4d170 100644
--- a/files/fr/web/api/permissions_api/index.md
+++ b/files/fr/web/api/permissions_api/index.md
@@ -3,81 +3,62 @@ title: Permissions API
 slug: Web/API/Permissions_API
 translation_of: Web/API/Permissions_API
 ---
-<p>{{DefaultAPISidebar("Permissions API")}}</p>
+{{DefaultAPISidebar("Permissions API")}}
 
-<p>L'API Permissions fournit une manière cohérente pour connaître, dans un programme, le statut des permissions dans le contexte courant. On pourra par exemple utiliser cette API afin de déterminer si la permission d'accéder à une API donnée a été accordée ou refusée.</p>
-</div>
+L'API Permissions fournit une manière cohérente pour connaître, dans un programme, le statut des permissions dans le contexte courant. On pourra par exemple utiliser cette API afin de déterminer si la permission d'accéder à une API donnée a été accordée ou refusée.
 
-<div class="notecard note">
-  <p><strong>Note :</strong> Cette fonctionnalité est disponible via <a href="/fr/docs/Web/API/Web_Workers_API">les Web Workers</a> bien que les versions actuelles de Firefox n'implémentent pas <a href="/fr/docs/Web/API/WorkerNavigator/permissions">WorkerNavigator.permissions</a>.</p>
-</div>
+> **Note :** Cette fonctionnalité est disponible via [les Web Workers](/fr/docs/Web/API/Web_Workers_API) bien que les versions actuelles de Firefox n'implémentent pas [WorkerNavigator.permissions](/fr/docs/Web/API/WorkerNavigator/permissions).
 
-<h2 id="concepts_and_usage">Concepts et usages</h2>
+## Concepts et usages
 
-<p>Historiquement les differentes API géraient leurs propres permissions de façon peu cohérente. L'API <a href="/fr/docs/Web/API/Notifications_API">Notifications</a> par exemple permet de vérifier explicitement l'état d'autorisation et de déclencher la demande de permission tandis que l'API <a href="/fr/docs/Web/API/Geolocation">Geolocation</a> ne permet pas ce fonctionnement (ce qui peut poser problème lorsque l'utilisateur a refusé la requête de permission initiale). L'API Permissions fournit un ensemble d'outils pour permettre aux développeuses et développeurs d'implémenter une meilleure ergonomie en ce qui concerne les permissions.</p>
+Historiquement les differentes API géraient leurs propres permissions de façon peu cohérente. L'API [Notifications](/fr/docs/Web/API/Notifications_API) par exemple permet de vérifier explicitement l'état d'autorisation et de déclencher la demande de permission tandis que l'API [Geolocation](/fr/docs/Web/API/Geolocation) ne permet pas ce fonctionnement (ce qui peut poser problème lorsque l'utilisateur a refusé la requête de permission initiale). L'API Permissions fournit un ensemble d'outils pour permettre aux développeuses et développeurs d'implémenter une meilleure ergonomie en ce qui concerne les permissions.
 
-<p>La propriété <code>permissions</code> est accessible via l'objet <a href="/fr/docs/Web/API/Navigator"><code>Navigator</code></a>, dans le contexte standard du navigateur et dans le contexte des <i lang="en">workers</i> (<a href="/fr/docs/Web/API/WorkerNavigator"><code>WorkerNavigator</code></a>, ce qui permet de vérifier l'état des permissions depuis les <i lang="en">workers</i>). Cette propriété renvoie un objet <a href="/fr/docs/Web/API/Permissions"><code>Permissions</code></a> qui fournit l'accès aux fonctionalités de l'API Permissions.</p>
+La propriété `permissions` est accessible via l'objet [`Navigator`](/fr/docs/Web/API/Navigator), dans le contexte standard du navigateur et dans le contexte des <i lang="en">workers</i> ([`WorkerNavigator`](/fr/docs/Web/API/WorkerNavigator), ce qui permet de vérifier l'état des permissions depuis les <i lang="en">workers</i>). Cette propriété renvoie un objet [`Permissions`](/fr/docs/Web/API/Permissions) qui fournit l'accès aux fonctionalités de l'API Permissions.
 
-<p>Lorsque cet objet a été récupéré, on peut réaliser différentes opérations relatives aux permissions. On peut par exemple connaître l'état d'une permission en utilisant la méthode <a href="/fr/docs/Web/API/Permissions/query"><code>Permissions.query()</code></a> qui renvoie une promesse dont la résolution est un objet <a href="/fr/docs/Web/API/PermissionStatus"><code>PermissionStatus</code></a> renseignant sur l'état d'autorisation pour une API donnée.</p>
+Lorsque cet objet a été récupéré, on peut réaliser différentes opérations relatives aux permissions. On peut par exemple connaître l'état d'une permission en utilisant la méthode [`Permissions.query()`](/fr/docs/Web/API/Permissions/query) qui renvoie une promesse dont la résolution est un objet [`PermissionStatus`](/fr/docs/Web/API/PermissionStatus) renseignant sur l'état d'autorisation pour une API donnée.
 
-<p>L'API Permissions ne donne pas accès aux permissions de l'ensemble des API. Voici un sous-ensemble d'API qui peuvent fonctionner avec l'API Permissions :</p>
+L'API Permissions ne donne pas accès aux permissions de l'ensemble des API. Voici un sous-ensemble d'API qui peuvent fonctionner avec l'API Permissions :
 
-<ul>
-  <li><a href="/fr/docs/Web/API/Clipboard_API">L'API Clipboard (pour la gestion du presse-papiers)</a></li>
-  <li><a href="/fr/docs/Web/API/Notifications_API">L'API Notifications</a></li>
-  <li><a href="/fr/docs/Web/API/Push_API">L'API Push</a></li>
-  <li>L'API Web MIDI</li>
- </ul>
+- [L'API Clipboard (pour la gestion du presse-papiers)](/fr/docs/Web/API/Clipboard_API)
+- [L'API Notifications](/fr/docs/Web/API/Notifications_API)
+- [L'API Push](/fr/docs/Web/API/Push_API)
+- L'API Web MIDI
 
-<p>À l'avenir, davantage d'API devraient être prises en charge par l'API Permissions.</p>
+À l'avenir, davantage d'API devraient être prises en charge par l'API Permissions.
 
-<h2 id="examples">Exemples</h2>
+## Exemples
 
-<p>Voici un exemple simple nommé <i lang="en">Location Finder</i>. Vous pouvez <a href="https://chrisdavidmills.github.io/location-finder-permissions-api/">lancer cet exemple en live ici</a>, ou <a href="https://github.com/chrisdavidmills/location-finder-permissions-api/tree/gh-pages">voir le code source sur GitHub</a>.</p>
+Voici un exemple simple nommé <i lang="en">Location Finder</i>. Vous pouvez [lancer cet exemple en live ici](https://chrisdavidmills.github.io/location-finder-permissions-api/), ou [voir le code source sur GitHub](https://github.com/chrisdavidmills/location-finder-permissions-api/tree/gh-pages).
 
-<p>Vous pouvez également en lire plus sur le fonctionnement de cet exemple dans l'article <a href="/fr/docs/Web/API/Permissions_API/Using_the_Permissions_API">Utiliser l'API Permissions</a>.</p>
+Vous pouvez également en lire plus sur le fonctionnement de cet exemple dans l'article [Utiliser l'API Permissions](/fr/docs/Web/API/Permissions_API/Using_the_Permissions_API).
 
-<h2 id="interfaces">Interfaces</h2>
+## Interfaces
 
-<dl>
- <dt><a href="/fr/docs/Web/API/Navigator/permissions"><code>Navigator.permissions</code></a> (respectivement <a href="/fr/docs/Web/API/WorkerNavigator/permissions"><code>WorkerNavigator.permissions</code></a>) {{readonlyinline}}</dt>
- <dd>Fournit un accès à l'objet <a href="/fr/docs/Web/API/Permissions"><code>Permissions</code></a> depuis le contexte principal (respectivement celui du worker).</dd>
- <dt><a href="/fr/docs/Web/API/Permissions"><code>Permissions</code></a></dt>
- <dd>Fournit les principales fonctionalités de l'API Permissions, telles que les méthodes de demande et de révocation des permissions.</dd>
- <dt><a href="/fr/docs/Web/API/PermissionStatus"><code>PermissionStatus</code></a></dt>
- <dd>Fournit l'accès à l'état actuel d'une permission ainsi qu'un gestionnaire d'évènements pour répondre aux changements d'état d'une permission.</dd>
-</dl>
+- [`Navigator.permissions`](/fr/docs/Web/API/Navigator/permissions) (respectivement [`WorkerNavigator.permissions`](/fr/docs/Web/API/WorkerNavigator/permissions)) {{readonlyinline}}
+  - : Fournit un accès à l'objet [`Permissions`](/fr/docs/Web/API/Permissions) depuis le contexte principal (respectivement celui du worker).
+- [`Permissions`](/fr/docs/Web/API/Permissions)
+  - : Fournit les principales fonctionalités de l'API Permissions, telles que les méthodes de demande et de révocation des permissions.
+- [`PermissionStatus`](/fr/docs/Web/API/PermissionStatus)
+  - : Fournit l'accès à l'état actuel d'une permission ainsi qu'un gestionnaire d'évènements pour répondre aux changements d'état d'une permission.
 
-<h2 id="specification">Spécifications</h2>
+## Spécifications
 
-<table class="standard-table">
- <thead>
-  <tr>
-    <th scope="col">Spécification</th>
-    <th scope="col">État</th>
-    <th scope="col">Commentaires</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName('Permissions API')}}</td>
-   <td>{{Spec2('Permissions API')}}</td>
-   <td>Définition initiale.</td>
-  </tr>
- </tbody>
-</table>
+| Spécification                            | État                                 | Commentaires         |
+| ---------------------------------------- | ------------------------------------ | -------------------- |
+| {{SpecName('Permissions API')}} | {{Spec2('Permissions API')}} | Définition initiale. |
 
-<h2 id="browser_compatibility">Compatibilité des navigateurs</h2>
+## Compatibilité des navigateurs
 
-<h3 id="permissions_interface">Interface <code>Permissions</code></h3>
+### Interface `Permissions`
 
-<p>{{Compat("api.Permissions")}}</p>
+{{Compat("api.Permissions")}}
 
-<h2 id="See_also">Voir aussi</h2>
+## Voir aussi
 
-<ul>
- <li><a href="/fr/docs/Web/API/Permissions_API/Using_the_Permissions_API">Utiliser l'API Permissions</a></li>
- <li><a href="https://blog.addpipe.com/using-permissions-api-to-detect-getusermedia-responses/"><i lang="en">Using the Permissions API to Detect How Often Users Allow or Deny Camera Access</i> (en anglais)</a></li>
- <li><a href="/fr/docs/Web/API/notification/permission"><code>Notification.permission</code></a></li>
- <li><a href="/fr/docs/Web/Privacy">Confidentialité, permissions et sécurité de l'information</a></li>
-</ul>
+- [Utiliser l'API Permissions](/fr/docs/Web/API/Permissions_API/Using_the_Permissions_API)
+- <i lang="en">Using the Permissions API to Detect How Often Users Allow or Deny Camera Access</i>
+
+  [<i lang="en">Using the Permissions API to Detect How Often Users Allow or Deny Camera Access</i> (en anglais)](https://blog.addpipe.com/using-permissions-api-to-detect-getusermedia-responses/)
+
+- [`Notification.permission`](/fr/docs/Web/API/notification/permission)
+- [Confidentialité, permissions et sécurité de l'information](/fr/docs/Web/Privacy)