diff --git a/write_documentation.md b/write_documentation.md
index ed1a0e64..2a748942 100644
--- a/write_documentation.md
+++ b/write_documentation.md
@@ -2,7 +2,9 @@
 
 ## Online
 
-This site allows to edit content directly online. You can edit any page by pressing `ESC` on your keyboard or by clicking the "Edit" button on the bottom-right side of your screen. You will be able to preview your changes by pressing `ESC` again or by clicking the "preview" button.
+This site allows to edit content directly online.
+
+You can edit any page by pressing `ESC` on your keyboard or by clicking the "Edit" button on the bottom-right side of your screen. You will be able to preview your changes by pressing `ESC` again or by clicking the "preview" button.
 
 Once edited, you are able to submit your change by filling an email address.
 
@@ -12,4 +14,4 @@ The YunoHost documentation is managed through a [git repository](https://github.
 
 ## Syntax
 
-This page use the markdown syntax, please refer to the [documentation](http://daringfireball.net/projects/markdown/syntax) for further information.
+This page use the markdown syntax, please refer to the [documentation](https://guides.github.com/features/mastering-markdown/) for further information.
diff --git a/write_documentation_fr.md b/write_documentation_fr.md
index 9563c764..df394f2c 100644
--- a/write_documentation_fr.md
+++ b/write_documentation_fr.md
@@ -1,17 +1,17 @@
 # Rédaction de la documentation
 
-## Sur le site
+## Sur le site
 
 Ce site permet d’éditer le contenu directement en ligne.
- 
+
 Pour éditer une page, appuyez pour la touche `Échap` ou cliquez sur le bouton « Éditer » en bas à droite de la page. Vous pourrez visualiser vos modifications en appuyant de nouveau sur `Échap`, ou en cliquant sur le bouton « Aperçu » en bas à droite de la page.
 
 Une fois l’édition effectuée, vous pouvez soumettre vos modifications en renseignant un mail.
 
-## Via GitHub
+## Via GitHub
 
-La documentation de YunoHost est gérée par un [dépot Git](https://github.com/YunoHost/doc). Vous pouvez envoyer des pull-requests. 
+La documentation de YunoHost est gérée par un [dépot Git](https://github.com/YunoHost/doc). Vous pouvez envoyer des pull-requests.
 
 ## Syntaxe
 
-La documentation utilise la syntaxe Markdown. Veuillez vous référer à la [documentation](http://daringfireball.net/projects/markdown/syntax) pour plus d’informations.
+La documentation utilise la syntaxe Markdown. Veuillez vous référer à la [documentation](https://guides.github.com/features/mastering-markdown/) (en) pour plus d’informations.