Vim Markdown-bestanden maken en bekijken

Vim Markdown Bestanden Maken En Bekijken



Markdown is een lichtgewicht, eenvoudig te gebruiken opmaaktaal die wordt gebruikt om tekst in een gewoon tekstbestand op te maken. Markdown-taal wordt veel gebruikt om README-bestanden te maken op platforms zoals GitHub, Trello, StackExchange en SourceForge. Het is niet beperkt tot het maken van README-bestanden; het wordt ook gebruikt om webinhoud, e-mails en technische documentatie te maken.

Vim kan worden gebruikt om markdown-bestanden rechtstreeks vanaf de terminal te maken, bewerken en uit te voeren. Met meerdere plug-ins kunt u de prijsverlaging typen en een live voorbeeld van de uitvoer bekijken.

In deze handleiding worden de mogelijkheden van Vim onderzocht om markdown-bestanden te maken, wijzigen en bekijken.







Opmerking: Voor de instructies in deze tutorial gebruik ik Linux (Ubuntu 22.04).



Vim geeft geen voorbeeld van de markdown-bestanden uit de doos weer. Er is een volledige installatie vereist om het opmaakbestand weer te geven. Om de live preview van markdown-bestanden in Vim in te schakelen, moeten bepaalde afhankelijkheden en vereisten worden geïnstalleerd.



De afhankelijkheden installeren

Om de markdown-bestanden met Vim uit te voeren, moet het volgende programma op Linux zijn geïnstalleerd:





  • Knooppunt.js
  • NPM

Om Node.js op Linux te installeren, gebruikt u:

sudo apt installeer nodejs

Vervolgens moet u de Node Package Manager (npm) installeren met behulp van de volgende opdracht:



sudo apt install npm

Om de Node.js-versie te verifiëren, gebruikt u de knooppunt -v opdracht en voor gebruik door pakketbeheerder npm-v . De npm wordt gebruikt om mini Node.js-servers te installeren die nodig zijn voor verschillende plug-ins voor het bekijken van Vim-markdown-bestanden.

Vereisten om Vim Markdown te bekijken

Om Vim voor te bereiden op het renderen van het markdown-bestand moet je de plug-ins gebruiken. De beste manier om de plug-ins in Vim te installeren is met behulp van de Vim-plug-inmanager. Op Vim kunnen verschillende plug-inbeheerders worden geïnstalleerd, zoals VimPlug, Pathogen, Neobundle of Vundle. Ik installeer de VimPlug, maar dat is afhankelijk van persoonlijke voorkeur.

VimPlug Plugin Manager voor Vim installeren

Voer eerst de onderstaande opdracht uit:

Krul - fLo ~/. omdat / automatisch laden / plug . omdat -- creëren - map \

https :// rauw . githubuserinhoud . met / junigunn / omdat - plug / meester / plug . omdat

Het bovenstaande commando de –create-dirs creëert de automatisch laden directory als deze niet bestaat en downloadt het VimPlug-bestand daar.

De Markdown Live Preview-plug-in installeren

Er zijn veel plug-ins die een live preview van het markdown-bestand bieden. Hieronder vindt u een lijst met dergelijke plug-ins:

Alle plug-ins doen hun werk zeer efficiënt. Voor deze tutorial installeer ik de plug-in Vim-Instant-Markdown omdat deze de browser opent om een ​​live voorbeeld van het bestand te bekijken zodra je een markdown-bestand in Vim opent.

Klik hier om de webpagina VimAwesome Vim-Instant-Markdown-plug-in te openen en kopieer de code voor VimPlug.

Open het vimrc-bestand met sudo-rechten:

sudo vim / enz / omdat / vimrc

Welnu, het wordt niet aanbevolen om de systeembestanden te bewerken. Maak daarom een ​​gebruikersspecifiek vimrc-bestand met behulp van de volgende opdracht.

omdat ~/. vimrc

Plaats de volgende regels in het bestand.

telefoongesprek plug#begin ( )

Plug 'suan/vim-instant-markdown'

telefoongesprek plug#einde ( )

U kunt elke plug-in installeren door de plug-incode ertussen te plaatsen bel plug#begin() En bel plug#end() tags in het vimrc-bestand. Sla het bestand op met de SHIFT+zz-toetsen of gebruik de opdracht :wq in de Vim-opdrachtmodus.

Open nu de Vim-editor met behulp van de omdat commando en rennen :PlugInstalleren in commandomodus.

: PlugInstalleren

De plug-in wordt geïnstalleerd en u bent helemaal klaar om het markdown-bestand te maken en er live een voorbeeld van te bekijken in de Vim-editor.

Een markdown-bestand maken in Vim

De nieuwste Vim biedt standaard accentuering van de syntaxis van markdown-bestanden.

Gebruik de volgende syntaxis om het markdown-bestand in Vim te maken:

omdat [ bestandsnaam ] . md

U kunt verschillende extensies gebruiken voor een markdown-bestand, zoals:

  • md
  • mkd
  • afwaardering

Laten we een afwaarderingsbestand maken.

# WELKOM

** Dit is Linux **

> Een website die tutorials gerelateerd biedt naar Linux en open - bronsoftware .

## Populaire categorieën

1 . Ubuntu

2 . Linux-opdrachten

3 . Waarom

### Commando naar Installeer knooppunt . js op Linux

`sudo apt install nodejs`

### Java Hallo wereldcode

```

klasse Hallo Wereld {

openbare statische leegte hoofd ( Snaar [ ] arg ) {

Systeem . uit . println ( 'Hallo Wereld!' ) ;

}

}

```

Bezoek [ Linux ] ( www . Linuxhint . met ) Nu !

In het bovenstaande bestand worden de hekjes (#, ##, ###) gebruikt om koppen met verschillende gewichten toe te voegen. Het groter dan (>) symbool wordt gebruikt om blokquote toe te voegen, en vinkjes (`, “`) worden gebruikt Om de commando's of codeblokken toe te voegen, zie voor meer markdown-bestandselementen het spiekbriefje in de volgende sectie.

Een voorbeeld van het Vim Markdown-bestand bekijken

Om het markdown-bestand te bekijken, hebt u een renderer nodig die het bestand kan vertalen en de uitvoer kan leveren zoals aangegeven. Net als een HTML-bestand waarvoor een webbrowser nodig is om het weer te geven, heeft een markdown-bestand ook een applicatie nodig om het te bekijken.

Er zijn veel renderer-apps beschikbaar die een markdown-bestand kunnen bekijken. Voor deze tutorial hebben we een Vim-plug-in geïnstalleerd waarmee we live een voorbeeld van het markdown-bestand kunnen bekijken.

Dus wanneer u een markdown-bestand opent, opent de Vim-Instant-Markdown-plug-in de browser voor een live preview-versie van het markdown-bestand in Vim.

Terwijl u het bestand in Vim bewerkt, vertaalt de plug-in de instructies tijdens runtime en geeft een live preview in de browser.

Een voorbeeld van de Vim Markdown bekijken in de terminal

De markdown-bestanden kunnen in de terminal worden gelezen met behulp van verschillende markdown-renderers zoals Pandoc of Glow. Laten we Glow installeren met behulp van Snap op Linux:

sudo snap install glow

Om nu een markdown-bestand in de terminal te bekijken, gebruikt u:

gloed [ bestandsnaam ] . md

Deze lezers interpreteren echter slechts een beperkt aantal Markdown-elementen en ondersteunen mogelijk niet alle functies. Naar mijn mening is het bekijken van de prijsverlaging vanaf de terminal geen goede keuze.

Het Markdown-bestand exporteren naar verschillende formaten met Vim

Een goede eigenschap van markdown-bestanden is dat u ze naar verschillende bestandsindelingen kunt exporteren, zoals documenten, pdf's en HTML. Daarvoor moet je een hulpprogramma genaamd pandoc installeren.

Om de pandoc op Linux te installeren, gebruik je:

sudo apt - krijgen installeer pandoc texlive - latex - basis texlive - lettertypen - aanbevolen texlive - extra - maakt gebruik van texlive - latex - extra

Voor PDF-conversie heeft u mogelijk extra hulpprogramma's nodig die in de bovenstaande opdracht worden genoemd.

Opmerking: Zorg ervoor dat u het bestand opslaat voordat u opdrachten uitvoert voor het exporteren van de markdown-bestanden naar een ander formaat.

Een Markdown-bestand converteren naar HTML

Gebruik de onderstaande opdracht om een ​​markdown-bestand naar HTML te converteren.

Opmerking: Gebruik makend van ! sign elk extern commando kan worden uitgevoerd in de Vim-editor.

:! pandoc [ bestandsnaam ] . md - O [ bestandsnaam ] . html

Een markdown-bestand naar PDF converteren

PDF is een algemeen geaccepteerd bestandsformaat; Om een ​​markdown-bestand naar een PDF te converteren, gebruikt u de onderstaande opdracht:

:! pandoc [ bestandsnaam ] . md - O [ bestandsnaam ] . pdf

Een Markdown-bestand converteren naar Docx

Docx is een ander bestandsformaat waarin een markdown-bestand kan worden geconverteerd.

:! pandoc [ bestandsnaam ] . md - O [ bestandsnaam ] . docx

Vervang de [bestandsnaam] in de bovenstaande opdrachten met de bestandsnamen die u wilt converteren.

Afwaarderingspiekbriefje

Veelgebruikte markdown-elementen worden weergegeven in de volgende afbeelding:

Conclusie

Vim is een krachtige editor die met behulp van plug-ins een nog betere optie wordt. Vim biedt de basissyntaxisaccentuering van de markdown-bestanden, zodat ze eenvoudig in de editor kunnen worden bewerkt. Om een ​​voorbeeld van de weergegeven vorm van het Markdown-bestand te bekijken, moet u bovendien een plug-in installeren, zoals Vim-Instant-Markdown. Met behulp van Linux-hulpprogramma's zoals pandoc kunnen markdown-bestanden naar verschillende bestandsformaten worden geëxporteerd.