Comment créer et prévisualiser des fichiers Vim Markdown

Vim peut être utilisé pour créer, modifier et exécuter des fichiers markdown directement depuis le terminal. Plusieurs plugins vous permettent de saisir la démarque et de prévisualiser en direct la sortie.

Ce guide explorera les capacités de Vim pour créer, modifier et prévisualiser des fichiers markdown.

• Installation des dépendances
• Conditions préalables pour prévisualiser Vim Markdown
• Installation du gestionnaire de plugins VimPlug pour Vim
• Installation du plugin Markdown Live Preview
• Création d'un fichier Markdown dans Vim
• Aperçu du fichier Vim Markdown
• Aperçu du Vim Markdown dans le terminal
• Exportation du fichier Markdown dans différents formats à l'aide de Vim
• Aide-mémoire de démarque
• Conclusion

Note: Pour les instructions de ce tutoriel, j'utilise Linux (Ubuntu 22.04).

Vim ne prévisualise pas les fichiers markdown prêts à l'emploi. Une configuration complète est nécessaire pour restituer le fichier de balisage. Pour activer l'aperçu en direct des fichiers markdown dans Vim, certaines dépendances et conditions préalables doivent être installées.

Installation des dépendances

Pour exécuter les fichiers markdown à l'aide de Vim, vous devez avoir installé le programme suivant sous Linux :

• Noeud.js
• MNP

Pour installer Node.js sur Linux, utilisez :

Ensuite, vous devez installer le Node Package Manager (npm), à l'aide de la commande suivante :

Pour vérifier la version de Node.js, utilisez le nœud -v commande et pour l'utilisation du gestionnaire de paquets npm-v . Le npm est utilisé pour installer les mini serveurs Node.js requis pour différents plugins de prévisualisation de fichiers de démarque Vim.

Conditions préalables pour afficher Vim Markdown

Pour préparer Vim au rendu du fichier markdown, vous devez utiliser les plugins. La meilleure façon d'installer les plugins sur Vim consiste à utiliser le gestionnaire de plugins Vim. Divers gestionnaires de plugins peuvent être installés sur Vim tels que VimPlug, Pathogen, Neobundle ou Vundle. J'installe le VimPlug, cependant, cela dépend de vos préférences personnelles.

Installation du gestionnaire de plugins VimPlug pour Vim

Tout d’abord, exécutez la commande mentionnée ci-dessous :

La commande ci-dessus le –créer des répertoires crée le chargement automatique répertoire s’il n’existe pas et y télécharge le fichier VimPlug.

Installation du plugin Markdown Live Preview

Il existe de nombreux plugins qui offrent un aperçu en direct du fichier de démarque. Une liste de ces plugins est donnée ci-dessous :

• Vim-Instant-Markdown
• Livedown.Vim
• MkdAperçu

Tous les plugins font leur travail de manière très efficace. Pour ce tutoriel, j'installerai le plugin Vim-Instant-Markdown car il ouvre le navigateur pour prévisualiser le fichier en direct dès que vous ouvrez un fichier markdown dans Vim.

Cliquez ici pour ouvrir la page Web du plugin VimAwesome Vim-Instant-Markdown et copier le code de VimPlug.

Ouvrez le fichier vimrc avec les privilèges sudo :

Eh bien, il n'est pas recommandé de modifier les fichiers système, par conséquent, créez un fichier vimrc spécifique à l'utilisateur à l'aide de la commande suivante.

Placez les lignes suivantes dans le fichier.

Vous pouvez installer n'importe quel plugin en plaçant le code du plugin entre appeler plug#begin() et appeler plug#end() balises dans le fichier vimrc. Enregistrez le fichier à l'aide des touches SHIFT+zz ou utilisez la commande :wq en mode commande Vim.

Maintenant, ouvrez l'éditeur Vim en utilisant le parce que commander et exécuter :PlugInstall en mode commande.

Il installera le plugin et vous êtes prêt à créer le fichier markdown et à le prévisualiser en direct dans l'éditeur Vim.

Création d'un fichier Markdown dans Vim

La dernière version de Vim fournit une mise en évidence de la syntaxe des fichiers markdown prête à l'emploi.

Pour créer le fichier markdown dans Vim, utilisez la syntaxe suivante :

Vous pouvez utiliser différentes extensions pour un fichier markdown, telles que :

• Maryland
• mkd
• réduction

Créons un fichier de démarque.

Dans le fichier ci-dessus, les signes dièse (#, ##, ###) sont utilisés pour ajouter des titres avec des poids différents, le symbole supérieur à (>) est utilisé pour ajouter des guillemets et les graduations (`, '`) sont utilisées. pour ajouter les commandes ou les blocs de code, pour plus d'éléments de fichier markdown, consultez l'aide-mémoire dans la section suivante.

Aperçu du fichier Vim Markdown

Pour afficher le fichier markdown, vous avez besoin d'un moteur de rendu capable de traduire le fichier et de fournir le résultat comme indiqué. Tout comme un fichier HTML qui nécessite un navigateur Web pour être affiché, un fichier markdown a également besoin d'une application pour l'afficher.

Il existe de nombreuses applications de rendu disponibles qui peuvent afficher un fichier markdown. Pour ce didacticiel, nous avons installé un plugin Vim qui peut nous aider à prévisualiser en direct le fichier markdown.

Ainsi, lorsque vous ouvrez un fichier de démarque, le plugin Vim-Instant-Markdown ouvre le navigateur sur une version rendue en aperçu en direct du fichier de démarque dans Vim.

Lorsque vous modifiez le fichier dans Vim, le plugin traduira les instructions au moment de l'exécution et donnera un aperçu en direct sur le navigateur.

Aperçu du Vim Markdown dans le terminal

Les fichiers de démarques peuvent être lus dans le terminal à l'aide de différents moteurs de rendu de démarques tels que Pandoc ou Glow. Installons Glow, en utilisant Snap sous Linux :

Maintenant, pour afficher un fichier markdown dans le terminal, utilisez :

Cependant, ces lecteurs n'interprètent qu'un nombre limité d'éléments Markdown et peuvent ne pas prendre en charge toutes les fonctionnalités. À mon avis, consulter la démarque depuis le terminal n'est pas un bon choix.

Exportation du fichier Markdown dans différents formats à l'aide de Vim

Une bonne caractéristique des fichiers markdown est que vous pouvez les exporter vers différents formats de fichiers tels que des documents, des PDF et du HTML. Pour cela, vous devez installer un utilitaire appelé pandoc.

Pour installer le pandoc sous Linux, utilisez :

Pour la conversion PDF, vous aurez peut-être besoin des utilitaires supplémentaires mentionnés dans la commande ci-dessus.

Note: Assurez-vous d'enregistrer le fichier avant d'exécuter des commandes pour exporter les fichiers markdown dans un format différent.

Conversion d'un fichier Markdown en HTML

Utilisez la commande ci-dessous pour convertir un fichier markdown en HTML.

Note: En utilisant ! signer n'importe quelle commande externe peut être exécutée dans l'éditeur Vim.

Conversion d'un fichier Markdown en PDF

Le PDF est un format de fichier largement accepté ; pour convertir un fichier markdown en PDF, utilisez la commande mentionnée ci-dessous :

Conversion d'un fichier Markdown en Docx

Docx est un autre format de fichier dans lequel un fichier markdown peut être converti.

Remplace le [nom de fichier] dans les commandes ci-dessus avec les noms de fichiers que vous souhaitez convertir.

Aide-mémoire de démarque

Les éléments de démarque couramment utilisés sont donnés dans l'image suivante :

Conclusion

Vim est un éditeur puissant qui, avec l'aide de plugins, devient une option encore meilleure. Vim fournit la coloration syntaxique de base des fichiers markdown, afin qu'ils puissent être facilement modifiés dans l'éditeur. De plus, pour prévisualiser la forme rendue du fichier Markdown, vous devez installer un plugin, tel que Vim-Instant-Markdown. Avec l'aide d'utilitaires Linux tels que les fichiers de démarque Pandoc peuvent être exportés dans différents formats de fichiers.