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. De temps en temps, je dois créer quelques fichiers. Lorsque je travaille avec plusieurs fichiers Markdown, j’attends généralement de les avoir terminés 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, je vais donc couvrir cela en premier, mais vous pouvez également le faire dans VSCodium sans la ligne de commande. Je vais couvrir ça aussi.
Conversion de plusieurs fichiers Markdown dans un autre format avec Pandoc [command line method]
Pour démarrer rapidement, Ubuntu et d’autres distributions Debian peuvent taper les commandes suivantes dans le terminal :
sudo apt-get install pandoc
Dans ce example, 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 sur une ligne qui :
- appelle pandoc
- lit les fichiers .md et les exporte au format .html
C’est la commande :
for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done
Si vous n’êtes pas déjà au courant, ;
est utilisé pour exécuter plusieurs commandes à la fois sous Linux.
Voici à quoi ressemble l’affichage une fois la commande exécutée :
[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 les 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 disposez de quatre fichiers HTML prêts à être transférés sur le serveur Web.
Pandoc est assez polyvalent et vous pouvez convertir les fichiers de démarques 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.
.ugb-a4f08a0-wrapper.ugb-container__wrapper{border-radius:0px !important;padding-top:0 !important;padding-bottom:0 !important;background-color:#f1f1f1 !important}.ugb-a4f08a0-wrapper > .ugb-container__side{padding-top:35px !important;padding-bottom:35px !important}.ugb-a4f08a0-wrapper.ugb-container__wrapper:before{background-color:#f1f1f1 !important}.ugb-a4f08a0-content -wrapper > h1,.ugb-a4f08a0-content-wrapper > h2,.ugb-a4f08a0-content-wrapper > h3,.ugb-a4f08a0-content-wrapper > h4,.ugb-a4f08a0-content-wrapper > h5,. ugb-a4f08a0-content-wrapper > h6{color:#222222}.ugb-a4f08a0-content-wrapper > p,.ugb-a4f08a0-content-wrapper > ol li,.ugb-a4f08a0-content-wrapper > ul li{ couleur : #222222}
Lecture recommandée :
.ugb-921b5c0 .ugb-blog-posts__featured-image{border-radius:0px !important}.ugb-921b5c0 .ugb-blog-posts__title a{color:#000000 !important}.ugb-921b5c0 .ugb-blog-posts__title a:hover{color:#00b6ba !important}
11 meilleurs éditeurs de démarques pour Linux
Une liste des meilleurs éditeurs Markdown pour les distributions Linux qui non seulement sont beaux, mais qui sont également riches en fonctionnalités.
Conversion de fichiers Markdown en HTML à l’aide de VSCodium [GUI method]
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é de le faire 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 :
- Le terminal de VSCodium
- Gestionnaire de plug-ins de VSCodium
Pour installer l’extension via le terminal de VSCodium :
- Cliquer sur
Terminal
dans la barre de menus. Le panneau à bornes s’ouvrira - Tapez ou copiez-collez la commande suivante dans le terminal :
codium --install-extension yzhang.markdown-all-in-one
Noter: Si vous utilisez VSCode au lieu de VSCodium, remplacez le mot, codium
, dans la commande ci-dessus, avec code
La deuxième façon d’installer consiste à utiliser le gestionnaire de plug-in ou d’extension 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, tapez :
Markdown All in One
. L’extension sera répertoriée en haut de la liste. Clique sur leInstall
bouton 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 qui contient 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 devez ouvrir au moins un fichier. Vous pouvez ouvrir autant de fichiers que vous le souhaitez, mais un seul 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’eux sera Markdown All in One: Print documents to HTML
commander. Cliquez sur celui-ci.
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 fait 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 en HTML peut avoir lieu lorsque vous êtes prêt – et vous avez deux façons de le faire.