Pour enregistrer une page web en Markdown, enregistrez-la dans Chrome ou Edge avec Ctrl+S au format Page web, complète, puis ajoutez le fichier HTML dans MD Factory. L’application convertit la page sur votre PC et enregistre à côté un fichier Markdown avec les images de la page.
Ce guide s’adresse aux pages que vous gardez pour vous : articles, documentation, recettes, pages de référence. Si vous devez convertir du HTML dans un script ou une chaîne de build, passez à la dernière section.
Enregistrer la page dans Chrome ou Edge
Dans Chrome, appuyez sur Ctrl+S, ou ouvrez le menu Plus, choisissez Caster, enregistrer et partager, puis Enregistrer la page sous. Les étapes figurent dans l’aide de Chrome.
Dans Edge, appuyez sur Ctrl+S. Le raccourci figure dans les raccourcis clavier d’Edge.
Dans la liste Type, choisissez Page web, complète. Les deux navigateurs proposent trois formats, et MD Factory les traite différemment :
| Type | Ce que le navigateur enregistre | Ce que vous obtenez dans MD Factory |
|---|---|---|
| Page web, complète | Un fichier HTML et un dossier du même nom se terminant par _files, qui contient les images | Texte et images |
| Page web, HTML uniquement | Seulement le fichier HTML ; les images restent sur le site web | Texte sans images, marqué À vérifier |
| Page web, fichier unique | Un fichier MHTML | Rien : MD Factory n’ouvre pas les fichiers MHTML et les liste comme ignorés |
Convertir la page enregistrée
- Ouvrez MD Factory.
- Cliquez sur Ajouter des fichiers et choisissez le fichier HTML enregistré, ou faites-le glisser dans la fenêtre.
- La conversion démarre immédiatement. Quand la ligne affiche le résultat, double-cliquez sur le chemin du résultat pour ouvrir le fichier Markdown.
Ajoutez le fichier HTML plutôt que le dossier qui le contient. Si vous ajoutez le dossier, MD Factory parcourt aussi le dossier _files : ses scripts, feuilles de style et images sont listés comme ignorés, et les fichiers HTML qu’il contient sont convertis en notes séparées.
Le fichier Markdown prend le nom de la page et est enregistré à côté. Les images qu’il utilise vont dans un dossier à côté :
Saved pages/
Sourdough bread.html
Sourdough bread_files/
Sourdough bread.md
Sourdough bread_images/La page enregistrée et son dossier _files restent tels quels. Si vous déplacez le fichier Markdown, déplacez aussi son dossier _images : le Markdown renvoie aux images de ce dossier.
Ce qui passe dans le Markdown
| Sur la page | Dans le Markdown |
|---|---|
| Titres | Titres du même niveau |
| Paragraphes, listes et citations | Conservés, avec le texte en gras et en italique |
| Blocs de code et code en ligne | Conservés comme code |
| Tableaux | Tableaux Markdown |
| Images enregistrées avec la page | Copiées dans le dossier d’images sous forme de fichiers PNG |
| Liens | Conservés, comme décrit plus bas |
| Scripts, styles et cadres intégrés, comme les lecteurs vidéo d’autres sites | Supprimés |
| Menus du site, en-têtes, pieds de page, barres latérales et avis sur les cookies | Conservés comme texte et liens ordinaires |
| Le titre de l’onglet du navigateur | Non inclus |
Si un tableau a des cellules d’en-tête, sa première ligne devient l’en-tête du tableau Markdown. Sinon, l’application ajoute des titres de colonnes numérotés. Les cellules fusionnées sont réparties sur la grille : la valeur reste dans la première cellule, et les cellules qu’elle couvrait restent vides.
Quelles images sont conservées
MD Factory ne télécharge jamais rien depuis Internet. Une image n’arrive dans le Markdown que si son fichier se trouve sur votre PC :
- les images du dossier _files que crée Page web, complète ;
- les images d’autres dossiers autour de la page, y compris les dossiers parents ;
- les images intégrées dans le code HTML lui-même.
Une image qui n’existe que sur le site web est omise, et le fichier est marqué À vérifier. Les images SVG ne sont pas prises en charge et sont omises aussi.
Comment les liens sont traités
- Les adresses web complètes, les liens e-mail et les liens téléphoniques restent exactement tels quels.
- Les liens relatifs, comme un lien vers une autre page du même site, deviennent des adresses web complètes si la page enregistrée conserve son adresse d’origine. Sinon, ils restent tels quels et ne fonctionnent que si le fichier ciblé se trouve au même endroit par rapport au fichier Markdown.
- Les liens vers une section de la même page continuent de fonctionner, car les sections gardent leurs ancres dans le Markdown.
- Les liens qui exécutent un script au clic, ceux qui commencent par javascript:, deviennent du texte brut.
Nettoyer la note
MD Factory convertit tout le corps de la page. Il ne devine pas quelle partie est l’article : attendez-vous donc au menu du site en haut, puis au pied de page, aux liens associés et à l’avis sur les cookies en bas. Supprimez ce dont vous n’avez pas besoin.
Le titre de l’onglet du navigateur n’est pas inclus. Si le titre propre à l’article manque, ajoutez-en un en haut.
Ajoutez l’adresse de la page et la date d’enregistrement comme première ligne de la note. Cela permet de retrouver l’original plus tard et de le citer.
Si vous gardez vos notes dans Obsidian, notre guide pour importer des documents dans Obsidian explique comment convertir des fichiers dans un coffre et garder leurs images liées.
Si la page obtient À vérifier
À vérifier signifie que le fichier Markdown a été enregistré, mais que quelque chose dans la page n’est pas passé. Une fois la file d’attente terminée, cliquez sur le statut dans la ligne du fichier pour voir le message.
| Message | Cause habituelle |
|---|---|
| Une image ou une ressource externe a été ignorée. | Une image n’existe que sur le site web, par exemple après un enregistrement au format Page web, HTML uniquement. |
| Une image n’a pas pu être exportée. | La page renvoie à un fichier image absent du dossier. |
| Un format d’image n’est pas pris en charge. | L’image est dans un format que l’application ne sait pas convertir, comme le SVG. |
| Certains contenus de documents n’ont pas pu être représentés dans Markdown. | La page contenait un cadre intégré, comme un lecteur vidéo d’un autre site, et il a été supprimé. |
| Une cible de lien local n’a pas pu être préservée. | Un lien vers une autre page du site n’a pu être associé ni à une adresse web ni à un fichier enregistré. Son texte est conservé sans le lien. |
| Le codage du texte a été déduit. Vérifiez les caractères spéciaux. | La page n’est pas enregistrée en UTF-8, l’application a donc dû déterminer son codage. Vérifiez les lettres accentuées et les symboles. |
Convertir du HTML dans du code
Si vous avez besoin de convertir du HTML en Markdown dans un script, une étape de build ou un scraper, MD Factory n’est pas le bon outil : il fonctionne par sa fenêtre, sans ligne de commande ni interface de programmation. Utilisez plutôt une bibliothèque. Turndown convertit le HTML en Markdown en JavaScript, dans Node.js ou dans le navigateur, sous licence MIT. html2text fait la même chose en Python, sous licence GPL-3.0. Pandoc est un convertisseur en ligne de commande entre de nombreux formats de documents, dont HTML et Markdown. Avec chacun d’eux, vous définissez vous-même les règles de conversion et gérez les images et les liens.
pandoc -f html -t gfm page.html -o page.md