Hvordan lage og forhåndsvise Vim Markdown-filer

Hvordan Lage Og Forhandsvise Vim Markdown Filer



Markdown er et lett og brukervennlig merkespråk som brukes til å formatere tekst i en ren tekstfil. Markdown-språket er mye brukt for å lage README-filer på plattformer som GitHub, Trello, StackExchange og SourceForge. Det er ikke begrenset til å lage README-filer; den brukes også til å lage webinnhold, e-poster og teknisk dokumentasjon.

Vim kan brukes til å opprette, redigere og utføre markdown-filer direkte fra terminalen. Flere plugins lar deg skrive inn markdown og live forhåndsvise utdataene.

Denne guiden vil utforske Vims evner til å lage, endre og forhåndsvise nedmerkingsfiler.







Merk: For instruksjonene i denne opplæringen bruker jeg Linux (Ubuntu 22.04).



Vim forhåndsviser ikke markdown-filene ut av esken. Det krever et fullstendig oppsett for å gjengi markup-filen. For å aktivere live forhåndsvisning av markdown-filer i Vim, må visse avhengigheter og forutsetninger installeres.



Installere avhengighetene

For å kjøre markdown-filene med Vim må du ha følgende program installert på Linux:





  • Node.js
  • NPM

For å installere Node.js på Linux bruk:

sudo apt install nodejs

Deretter må du installere Node Package Manager (npm), ved å bruke følgende kommando:



sudo apt installer npm

For å bekrefte Node.js-versjonen, bruk node -v kommando og for bruk av pakkebehandleren npm -v . De npm brukes til å installere mini Node.js-servere som kreves for forskjellige forhåndsvisningsplugins for Vim-fil.

Forutsetninger for å se Vim Markdown

For å forberede Vim for å gjengi markdown-filen må du bruke plugins. Den beste måten å installere plugins på Vim er å bruke Vim plugin manager. Ulike plugin-administratorer kan installeres på Vim som VimPlug, Pathogen, Neobundle eller Vundle. Jeg installerer VimPlug, men det er opp til personlig preferanse.

Installere VimPlug Plugin Manager for Vim

Først, utfør kommandoen nevnt nedenfor:

krølle - fLo ~/. fordi / automatisk lasting / støpsel . fordi -- skape - dirs \

https :// . githubuserinnhold . med / junigunn / fordi - støpsel / herre / støpsel . fordi

Ovennevnte kommando –skape-dir skaper automatisk lasting katalogen hvis den ikke eksisterer og laster ned VimPlug-filen der.

Installere Markdown Live Preview Plugin

Mange plugins er der som tilbyr en live forhåndsvisning av markdown-filen. En liste over slike plugins er gitt nedenfor:

Alle plugins gjør jobben sin veldig effektivt. For denne opplæringen vil jeg installere Vim-Instant-Markdown-pluginet fordi det åpner nettleseren for å forhåndsvise filen så snart du åpner en markdown-fil i Vim.

Klikk her for å åpne VimAwesome Vim-Instant-Markdown plugin-nettsiden og kopiere koden for VimPlug.

Åpne filen vimrc med sudo-privilegier:

sudo vim / etc / fordi / vimrc

Vel, det anbefales ikke å redigere systemfilene, derfor lag en brukerspesifikk vimrc-fil ved å bruke følgende kommando.

fordi ~/. vimrc

Plasser følgende linjer i filen.

anrop plugg#begynn ( )

Støpsel 'suan/vim-instant-markdown'

anrop plugg#end ( )

Du kan installere et hvilket som helst plugin ved å plassere plugin-koden mellom kall plugg#begin() og kall plugg#end() koder i vimrc-filen. Lagre filen ved å bruke SHIFT+zz-tastene eller bruk :wq-kommandoen i Vim-kommandomodus.

Åpne nå Vim-editoren ved å bruke fordi kommando og kjør :PlugInstall i kommandomodus.

: PlugInstall

Den vil installere plugin-en, og du er klar til å lage markdown-filen og forhåndsvise den i Vim-editoren.

Opprette en Markdown-fil i Vim

Den nyeste Vim gir markdown-filsyntaksutheving rett ut av esken.

For å lage markdown-filen i Vim, bruk følgende syntaks:

fordi [ filnavn ] . md

Du kan bruke forskjellige utvidelser for en markdown-fil, for eksempel:

  • md
  • mkd
  • nedskrivning

La oss lage en markdown-fil.

# VELKOMMEN

** Dette er Linux **

> Et nettsted som tilbyr opplæringsrelaterte til Linux og åpen - kildeprogramvare .

## Populære kategorier

1 . Ubuntu

2 . Linux-kommandoer

3 . Hvorfor

### Kommando til Installer Node . js Linux

`sudo apt install nodejs`

### Java Hello World Code

```

klasse HelloWorld {

offentlig statisk tomrom hoved ( String [ ] args ) {

System . ute . println ( 'Hei Verden!' ) ;

}

}

```

Besøk [ Linux ] ( www . linuxhint . med ) !

I filen ovenfor brukes hash-tegnene (#, ##, ###) for å legge til overskrifter med forskjellig vekt, symbolet for større enn (>) brukes for å legge til blokkanførselstegn, og haker (`, “`) brukes for å legge til kommandoer eller kodeblokker, for flere markdown-filelementer, se juksearket i den følgende delen.

Forhåndsvisning av Vim Markdown-filen

For å se markdown-filen trenger du en gjengiver som kan oversette filen og gi utdataene som instruert. Akkurat som en HTML-fil som krever en nettleser for å gjengi den, trenger en markdown-fil også et program for å se den.

Det er mange tilgjengelige gjengivelsesapper som kan se en markdown-fil, for denne opplæringen har vi installert en Vim-plugin som kan hjelpe oss med å forhåndsvise markdown-filen.

Så når du åpner en markdown-fil, åpner Vim-Instant-Markdown-pluginen nettleseren til en live forhåndsvisningsgjengitt versjon av markdown-filen i Vim.

Når du redigerer filen i Vim, vil plugin-en oversette instruksjonene på runtime og gi en live forhåndsvisning på nettleseren.

Forhåndsvisning av Vim Markdown i terminalen

Markdown-filene kan leses i terminalen ved å bruke forskjellige markdown-renderere som Pandoc eller Glow. La oss installere Glow ved å bruke Snap på Linux:

sudo snap install glød

Nå, for å se en markdown-fil i terminalen, bruk:

gløde [ filnavn ] . md

Disse leserne tolker imidlertid bare et begrenset antall Markdown-elementer og støtter kanskje ikke alle funksjoner. Etter min mening er det ikke et godt valg å se markdown fra terminalen.

Eksportere Markdown-filen til forskjellige formater ved hjelp av Vim

En god funksjon med markdown-filer er at du kan eksportere dem til forskjellige filformater som dokumenter, PDF-er og HTML. For det må du installere et verktøy kalt pandoc.

For å installere Pandoc på Linux, bruk:

sudo apt - installer Pandoc texlive - lateks - base texlive - fonter - anbefalt texlive - ekstra - utils texlive - lateks - ekstra

For PDF-konvertering kan det hende du trenger ekstra verktøy nevnt i kommandoen ovenfor.

Merk: Sørg for å lagre filen før du utfører kommandoer for å eksportere markdown-filene til et annet format.

Konvertering av en Markdown-fil til HTML

Bruk kommandoen nedenfor for å konvertere en markdown-fil til HTML.

Merk: Ved hjelp av ! signere enhver ekstern kommando kan utføres i Vim-editoren.

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

Konvertering av en Markdown-fil til PDF

PDF er et allment akseptert filformat; for å konvertere en markdown-fil til en PDF, bruk kommandoen nevnt nedenfor:

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

Konvertering av en Markdown-fil til Docx

Docx er et annet filformat en markdown-fil kan konverteres.

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

Bytt ut [filnavn] i kommandoene ovenfor med filnavnene du vil konvertere.

Markdown Cheat Sheet

Vanlig brukte markdown-elementer er gitt i følgende bilde:

Konklusjon

Vim er en kraftig editor som ved hjelp av plugins blir et enda bedre alternativ. Vim gir den grunnleggende syntaksuthevingen av markdown-filene, slik at de enkelt kan redigeres i redigeringsprogrammet. I tillegg, for å forhåndsvise den gjengitte formen til Markdown-filen, må du installere en plugin, for eksempel Vim-Instant-Markdown. Ved hjelp av Linux-verktøy som Pandoc Markdown-filer kan du eksportere til forskjellige filformater.