Souvent, lorsque j'utilise Markdown, je travaille sur un fichier et lorsque j'en ai terminé, je le convertis en HTML ou dans un autre format. Parfois, je dois créer quelques fichiers. Lorsque je travaille avec plusieurs fichiers Markdown, j'attends généralement d'avoir terminé avant de les convertir.
J'utilise pandoc pour convertir des fichiers, et il est possible de convertir tous les fichiers Markdown en une seule fois.
Markdown peut convertir ses fichiers en .html, mais s'il y a une chance que je doive convertir vers d'autres formats comme epub, pandoc est l'outil à utiliser. Je préfère utiliser la ligne de commande, donc je vais d'abord couvrir cela, mais vous pouvez également le faire dans VSCodium sans la ligne de commande. Je couvrirai ça aussi.
Convertir plusieurs fichiers Markdown dans un autre format avec Pandoc [méthode de ligne de commande]
Pour démarrer rapidement, Ubuntu et d'autres distributions Debian peuvent saisir les commandes suivantes dans le terminal :
sudo apt-get install pandocDans cet exemple, j'ai quatre fichiers Markdown dans un répertoire appelé md_test.
[email protected]:~/Documents/md_test$ ls -l *.md
-rw-r--r-- 1 bdyer bdyer 3374 Apr 7 2020 file01.md
-rw-r--r-- 1 bdyer bdyer 782 Apr 2 05:23 file02.md
-rw-r--r-- 1 bdyer bdyer 9257 Apr 2 05:21 file03.md
-rw-r--r-- 1 bdyer bdyer 9442 Apr 2 05:21 file04.md
[email protected]:~/Documents/md_test$Il n'y a pas encore de fichiers HTML. Maintenant, je vais utiliser Pandoc pour faire sa magie sur la collection de fichiers. Pour ce faire, j'exécute une commande d'une ligne qui :
- appelle pandoc
- lit les fichiers .md et les exporte au format .html
Voici la commande :
for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done
Si vous ne le savez pas déjà, ; est utilisé pour exécuter plusieurs commandes à la fois sous Linux.
Voici à quoi ressemble l'affichage une fois que j'ai exécuté la commande :
[email protected]:~/Documents/md_test$ for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done
file01.md
file02.md
file03.md
file04.md
[email protected]:~/Documents/md_test$
Permettez-moi d'utiliser le ls commande une fois de plus pour voir si des fichiers HTML ont été créés :
[email protected]:~/Documents/md_test$ ls -l *.html
-rw-r--r-- 1 bdyer bdyer 4291 Apr 2 06:08 file01.md.html
-rw-r--r-- 1 bdyer bdyer 1781 Apr 2 06:08 file02.md.html
-rw-r--r-- 1 bdyer bdyer 10272 Apr 2 06:08 file03.md.html
-rw-r--r-- 1 bdyer bdyer 10502 Apr 2 06:08 file04.md.html
[email protected]:~/Documents/md_test$La conversion a été un succès, et vous avez quatre fichiers HTML prêts à aller sur le serveur Web.
Pandoc est assez polyvalent et vous pouvez convertir les fichiers Markdown dans un autre format pris en charge en spécifiant l'extension des fichiers de sortie. Vous pouvez comprendre pourquoi il est considéré comme l'un des meilleurs outils open source pour les écrivains.
Lecture recommandée :
11 meilleurs éditeurs Markdown pour Linux
Une liste des meilleurs éditeurs Markdown pour les distributions Linux qui sont non seulement beaux, mais également riches en fonctionnalités.
Conversion de fichiers Markdown en HTML à l'aide de VSCodium [méthode GUI]
Comme je l'ai dit plus tôt, j'utilise normalement la ligne de commande, mais je ne l'utilise pas toujours pour les conversions par lots, et vous n'êtes pas obligé non plus. VSCode ou VSCodium peuvent faire le travail. Il vous suffit d'ajouter une extension, appelée :Markdown-All-in-One qui vous permettra de convertir plus d'un fichier Markdown en une seule fois.
Il existe deux manières d'installer l'extension :
- Terminal de VSCodium
- Gestionnaire de plug-ins de VSCodium
Pour installer l'extension via le terminal de VSCodium :
- Cliquez sur
Terminaldans la barre de menus. Le panneau terminal s'ouvrira - Tapez ou copiez-collez la commande suivante dans le terminal :
codium --install-extension yzhang.markdown-all-in-one
Remarque :Si vous utilisez VSCode au lieu de VSCodium, remplacez le mot codium , dans la commande ci-dessus, avec code
La deuxième méthode d'installation consiste à utiliser le gestionnaire de plug-ins ou d'extensions de VSCodium :
- Cliquez sur les blocs sur le côté gauche de la fenêtre VSCodium. Une liste d'extensions apparaîtra. En haut de la liste, il y aura une barre de recherche.
- Dans la barre de recherche, saisissez :
Markdown All in One. L'extension sera répertoriée en haut de la liste. Cliquez surInstallbouton pour l'installer. S'il est déjà installé, une icône d'engrenage apparaîtra à la place du bouton d'installation.
Une fois l'extension installée, vous pouvez ouvrir le dossier contenant les fichiers Markdown que vous souhaitez convertir.
Cliquez sur l'icône de papier située sur le côté gauche de la fenêtre VSCodium. Vous aurez la possibilité de choisir votre dossier. Une fois qu'un dossier est ouvert, vous devrez ouvrir au moins un fichier. Vous pouvez ouvrir autant de fichiers que vous le souhaitez, mais un est le minimum.
Une fois qu'un fichier est ouvert, affichez la palette de commandes en appuyant sur CTRL+SHIFT+P . Ensuite, commencez à taper Markdown dans la barre de recherche qui apparaîtra. Pendant que vous faites cela, une liste de commandes liées à Markdown apparaîtra. L'un d'entre eux sera Markdown All in One: Print documents to HTML commande. Cliquez dessus.
Il vous sera demandé de choisir un dossier contenant les fichiers. Il s'agit donc d'un répertoire de sortie (appelé out ) peut être créé et c'est là que les fichiers HTML iront. L'image ci-dessous montre que le HTML a été créé après l'exportation des documents Markdown. À partir de là, vous pouvez ouvrir, afficher et modifier le code HTML à votre guise.
En attendant de convertir vos fichiers Markdown, vous pouvez vous concentrer davantage sur l'écriture. La conversion au format HTML peut intervenir lorsque vous êtes prêt, et vous avez deux façons d'y parvenir.