Sådan oprettes og forhåndsvises Vim Markdown-filer

Sadan Oprettes Og Forhandsvises Vim Markdown Filer



Markdown er et let og brugervenligt opmærkningssprog, der bruges til at formatere tekst i en almindelig tekstfil. Markdown-sprog er meget brugt til at skabe README-filer på platforme som GitHub, Trello, StackExchange og SourceForge. Det er ikke begrænset til at oprette README-filer; det bruges også til at oprette webindhold, e-mails og teknisk dokumentation.

Vim kan bruges til at oprette, redigere og udføre markdown-filer direkte fra terminalen. Flere plugins giver dig mulighed for at skrive markdown og live preview output.

Denne vejledning vil udforske Vims muligheder for at oprette, ændre og forhåndsvise markdown-filer.







Bemærk: For instruktionerne i denne tutorial bruger jeg Linux (Ubuntu 22.04).



Vim forhåndsviser ikke markdown-filerne ud af boksen. Det kræver en komplet opsætning at gengive markup-filen. For at aktivere live forhåndsvisning af markdown-filer i Vim, skal visse afhængigheder og forudsætninger installeres.



Installation af afhængigheder

For at køre markdown-filerne ved hjælp af Vim skal du have følgende program installeret på Linux:





  • Node.js
  • NPM

For at installere Node.js på Linux skal du bruge:

sudo apt installer nodejs

Derefter skal du installere Node Package Manager (npm) ved hjælp af følgende kommando:



sudo apt installer npm

For at bekræfte Node.js-versionen skal du bruge node -v kommando og til pakkehåndteringsbrug npm -v . Det npm bruges til at installere mini Node.js-servere, der kræves til forskellige Vim markdown-fil forhåndsvisningsplugins.

Forudsætninger for at se Vim Markdown

For at forberede Vim til at gengive markdown-filen skal du bruge plugins. Den bedste måde at installere plugins på Vim er at bruge Vim plugin manager. Forskellige plugin-managere kan installeres på Vim såsom VimPlug, Pathogen, Neobundle eller Vundle. Jeg installerer VimPlug, men det er op til personlig præference.

Installation af VimPlug Plugin Manager for Vim

Først skal du udføre kommandoen nævnt nedenfor:

krølle - fLo ~/. fordi / automatisk indlæsning / prop . fordi -- skab - dirs \

https :// . githubuserindhold . med / junigunn / fordi - prop / mestre / prop . fordi

Ovenstående kommando –opret-dir skaber automatisk indlæsning mappe, hvis den ikke findes og downloader VimPlug-filen der.

Installation af Markdown Live Preview Plugin

Mange plugins er der, der tilbyder en live forhåndsvisning af markdown-filen. En liste over sådanne plugins er givet nedenfor:

Alle plugins udfører deres arbejde meget effektivt. Til denne vejledning vil jeg installere Vim-Instant-Markdown-plugin'et, fordi det åbner browseren for at se filen live, så snart du åbner en markdown-fil i Vim.

Klik her for at åbne VimAwesome Vim-Instant-Markdown plugin-websiden og kopiere koden til VimPlug.

Åbn filen vimrc med sudo-rettigheder:

sudo vim / etc / fordi / vimrc

Nå, det anbefales ikke at redigere systemfilerne, derfor skal du oprette en brugerspecifik vimrc-fil ved hjælp af følgende kommando.

fordi ~/. vimrc

Placer følgende linjer i filen.

opkald plug#begynd ( )

Prop 'suan/vim-instant-markdown'

opkald stik#ende ( )

Du kan installere ethvert plugin ved at placere plugin-koden mellem kald plug#begin() og kald plug#end() tags i vimrc-filen. Gem filen ved hjælp af SHIFT+zz-tasterne eller brug :wq-kommandoen i Vim-kommandotilstanden.

Åbn nu Vim-editoren ved hjælp af fordi kommando og kør :PlugInstall i kommandotilstand.

: PlugInstall

Det vil installere plugin'et, og du er klar til at oprette markdown-filen og live forhåndsvisning af den i Vim-editoren.

Oprettelse af en Markdown-fil i Vim

Den seneste Vim giver markdown-filsyntaksfremhævning ud af boksen.

For at oprette markdown-filen i Vim skal du bruge følgende syntaks:

fordi [ filnavn ] . md

Du kan bruge forskellige udvidelser til en markdown-fil, såsom:

  • md
  • mkd
  • nedskrivning

Lad os oprette en markdown-fil.

# VELKOMMEN

** Det her er Linux **

> En hjemmeside, der tilbyder tutorials relateret til Linux og åben - kildesoftware .

## 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 tomrum hoved ( Snor [ ] args ) {

System . ud . println ( 'Hej Verden!' ) ;

}

}

```

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

I ovenstående fil bruges hash-tegnene (#, ##, ###) til at tilføje overskrifter med forskellig vægt, symbolet for større end (>) bruges til at tilføje blokanførselstegn, og flueben (`, “`) bruges for at tilføje kommandoerne eller kodeblokkene, for flere markdown-filelementer se snydearket i det følgende afsnit.

Forhåndsvisning af Vim Markdown-filen

For at se markdown-filen skal du bruge en renderer, der kan oversætte filen og levere output som anvist. Ligesom en HTML-fil, der kræver en webbrowser for at gengive den, skal en markdown-fil også bruge et program for at se den.

Der er mange tilgængelige render-apps, der kan se en markdown-fil, til denne tutorial har vi installeret et Vim-plugin, der kan hjælpe os med at se markdown-filen live.

Så når du åbner en markdown-fil, åbner Vim-Instant-Markdown-plugin'et browseren til en live preview-renderet version af markdown-filen i Vim.

Når du redigerer filen i Vim, vil plugin'et oversætte instruktionerne på runtime og give et live preview på browseren.

Forhåndsvisning af Vim Markdown i terminalen

Markdown-filerne kan læses i terminalen ved hjælp af forskellige markdown-renderere såsom Pandoc eller Glow. Lad os installere Glow ved hjælp af Snap på Linux:

sudo snap install glød

Brug nu for at se en markdown-fil i terminalen:

glød [ filnavn ] . md

Disse læsere fortolker dog kun et begrænset antal Markdown-elementer og understøtter muligvis ikke alle funktioner. Efter min mening er det ikke et godt valg at se markdown fra terminalen.

Eksport af Markdown-filen til forskellige formater ved hjælp af Vim

En god funktion ved markdown-filer er, at du kan eksportere dem til forskellige filformater såsom dokumenter, PDF'er og HTML. Til det skal du installere et hjælpeprogram kaldet pandoc.

For at installere Pandoc på Linux skal du bruge:

sudo apt - installer Pandoc texlive - latex - base texlive - skrifttyper - anbefalet texlive - ekstra - utils texlive - latex - ekstra

Til PDF-konvertering skal du muligvis bruge ekstra værktøjer nævnt i ovenstående kommando.

Bemærk: Sørg for at gemme filen, før du udfører kommandoer til eksport af markdown-filer til et andet format.

Konvertering af en Markdown-fil til HTML

Brug kommandoen nedenfor til at konvertere en markdown-fil til HTML.

Bemærk: Ved brug af ! sign kan enhver ekstern kommando udføres i Vim-editoren.

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

Konvertering af en Markdown-fil til PDF

PDF er et bredt accepteret filformat; for at konvertere en markdown-fil til en PDF, brug kommandoen nævnt nedenfor:

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

Konvertering af en Markdown-fil til Docx

Docx er et andet filformat, en markdown-fil kan konverteres.

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

Udskift [filnavn] i ovenstående kommandoer med de filnavne, du vil konvertere.

Markdown snydeark

Almindeligt brugte markdown-elementer er angivet i følgende billede:

Konklusion

Vim er en kraftfuld editor, der ved hjælp af plugins bliver en endnu bedre mulighed. Vim giver den grundlæggende syntaksfremhævning af markdown-filerne, så de nemt kan redigeres i editoren. Derudover skal du installere et plugin, såsom Vim-Instant-Markdown, for at få vist den gengivede form af Markdown-filen. Ved hjælp af Linux-værktøjer såsom pandoc markdown-filer kan eksporteres til forskellige filformater.