Hur man skapar och förhandsgranskar Vim Markdown-filer

Hur Man Skapar Och Forhandsgranskar Vim Markdown Filer



Markdown är ett lätt och lättanvänt märkningsspråk som används för att formatera text i en vanlig textfil. Markdown-språk används ofta för att skapa README-filer på plattformar som GitHub, Trello, StackExchange och SourceForge. Det är inte begränsat till att skapa README-filer; det används också för att skapa webbinnehåll, e-postmeddelanden och teknisk dokumentation.

Vim kan användas för att skapa, redigera och köra markdown-filer direkt från terminalen. Flera plugins låter dig skriva markdown och live förhandsgranska resultatet.

Den här guiden kommer att utforska Vims möjligheter att skapa, ändra och förhandsgranska markdown-filer.







Notera: För instruktionerna i denna handledning använder jag Linux (Ubuntu 22.04).



Vim förhandsgranskar inte markdown-filerna direkt. Det kräver en fullständig installation för att rendera uppmärkningsfilen. För att aktivera liveförhandsvisningen av markdown-filer i Vim måste vissa beroenden och förutsättningar installeras.



Installera beroenden

För att köra markdown-filerna med Vim måste du ha följande program installerat på Linux:





  • Node.js
  • NPM

För att installera Node.js på Linux använd:

sudo apt installera nodejs

Sedan måste du installera Node Package Manager (npm), med följande kommando:



sudo apt installera npm

För att verifiera Node.js-versionen använd nod -v kommando och för användning av pakethanteraren npm -v . De npm används för att installera mini Node.js-servrar som krävs för olika plugins för förhandsgranskning av Vim-fil.

Förutsättningar för att se Vim Markdown

För att förbereda Vim för att rendera markdown-filen måste du använda plugins. Det bästa sättet att installera plugins till Vim är att använda Vim plugin manager. Olika pluginhanterare kan installeras på Vim som VimPlug, Pathogen, Neobundle eller Vundle. Jag installerar VimPlug, men det är upp till personliga preferenser.

Installerar VimPlug Plugin Manager för Vim

Kör först kommandot som nämns nedan:

ringla - fLo ~/. därför att / automatisk laddning / plugg . därför att -- skapa - dirs \

https :// . githubuserinnehåll . med / junigunn / därför att - plugg / bemästra / plugg . därför att

Ovanstående kommando –skapa-dir skapar automatisk laddning katalogen om den inte finns och laddar ner VimPlug-filen där.

Installera Markdown Live Preview Plugin

Många plugins finns där som erbjuder en liveförhandsvisning av markdown-filen. En lista över sådana plugins ges nedan:

Alla plugins gör sitt jobb mycket effektivt. För den här handledningen kommer jag att installera plugin-programmet Vim-Instant-Markdown eftersom det öppnar webbläsaren för att liveförhandsgranska filen så snart du öppnar någon markdown-fil i Vim.

Klicka här för att öppna VimAwesome Vim-Instant-Markdown-plugin-webbsidan och kopiera koden för VimPlug.

Öppna filen vimrc med sudo-privilegier:

sudo vim / etc / därför att / vimrc

Tja, det rekommenderas inte att redigera systemfilerna, därför skapa en användarspecifik vimrc-fil med följande kommando.

därför att ~/. vimrc

Placera följande rader i filen.

ring upp plug #start ( )

Plugg 'suan/vim-instant-markdown'

ring upp plugg#end ( )

Du kan installera vilket plugin som helst genom att placera pluginkoden mellan ring plug#begin() och ring plug#end() taggar i vimrc-filen. Spara filen med SHIFT+zz-tangenterna eller använd :wq-kommandot i Vim-kommandoläget.

Öppna nu Vim-redigeraren med hjälp av därför att kommando och kör :PlugInstall i kommandoläge.

: PlugInstall

Det kommer att installera plugin och du är redo att skapa markdown-filen och liveförhandsgranska den i Vim-redigeraren.

Skapa en Markdown-fil i Vim

Den senaste Vim ger markdown-filsyntaxmarkering direkt.

För att skapa markdown-filen i Vim, använd följande syntax:

därför att [ filnamn ] . md

Du kan använda olika tillägg för en markdown-fil, till exempel:

  • md
  • mkd
  • prissänkning

Låt oss skapa en markdown-fil.

# VÄLKOMMEN

** Detta är Linux **

> En webbplats som erbjuder handledningsrelaterade till Linux och öppen - källprogramvara .

## Populära kategorier

1 . Ubuntu

2 . Linux-kommandon

3 . Varför

### Kommando till Installera Node . js Linux

`sudo apt install nodejs`

### Java Hello World Code

```

klass HelloWorld {

offentliga statiska tomrum huvud ( Sträng [ ] args ) {

Systemet . ut . println ( 'Hej världen!' ) ;

}

}

```

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

I filen ovan används hash-tecknen (#, ##, ###) för att lägga till rubriker med olika vikt, symbolen större än (>) används för att lägga till citat, och bockar (`, “`) används för att lägga till kommandon eller kodblock, för fler markdown-filelement, se fuskbladet i följande avsnitt.

Förhandsgranska Vim Markdown-filen

För att se markdown-filen behöver du en renderare som kan översätta filen och tillhandahålla utdata enligt instruktionerna. Precis som en HTML-fil som kräver en webbläsare för att rendera den, behöver en markdown-fil också ett program för att visa den.

Det finns många tillgängliga renderarappar som kan visa en markdown-fil, för den här handledningen har vi installerat ett Vim-plugin som kan hjälpa oss att liveförhandsgranska markdown-filen.

Så när du öppnar en markdown-fil öppnar plugin-programmet Vim-Instant-Markdown webbläsaren för en liveförhandsvisningsrenderad version av markdown-filen i Vim.

När du redigerar filen i Vim översätter plugin instruktionerna för körning och ger en liveförhandsvisning i webbläsaren.

Förhandsgranska Vim Markdown i terminalen

Markdown-filerna kan läsas i terminalen med hjälp av olika markdown-renderare som Pandoc eller Glow. Låt oss installera Glow med Snap på Linux:

sudo snap install glöd

Nu, för att se en markdown-fil i terminalen, använd:

glöd [ filnamn ] . md

Dessa läsare tolkar dock bara ett begränsat antal Markdown-element och kanske inte stöder alla funktioner. Enligt min åsikt är det inte ett bra val att titta på markdown från terminalen.

Exportera Markdown-filen till olika format med Vim

En bra funktion med markdown-filer är att du kan exportera dem till olika filformat som dokument, PDF-filer och HTML. För det måste du installera ett verktyg som heter pandoc.

För att installera Pandoc på Linux, använd:

sudo apt - skaffa sig installera Pandoc texlive - latex - bas texlive - teckensnitt - rekommenderas texlive - extra - utils texlive - latex - extra

För PDF-konvertering kan du behöva extra verktyg som nämns i kommandot ovan.

Notera: Se till att spara filen innan du kör kommandon för att exportera nedmärkningsfilerna till ett annat format.

Konvertera en Markdown-fil till HTML

Använd kommandot nedan för att konvertera en markdown-fil till HTML.

Notera: Använder sig av ! signera vilket externt kommando som helst kan köras i Vim-redigeraren.

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

Konvertera en Markdown-fil till PDF

PDF är ett allmänt accepterat filformat; för att konvertera en markdown-fil till en PDF använd kommandot som nämns nedan:

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

Konvertera en Markdown-fil till Docx

Docx är ett annat filformat som en markdown-fil kan konverteras.

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

Ersätt [filnamn] i ovanstående kommandon med filnamnen som du vill konvertera.

Markdown Cheat Sheet

Vanligt använda markdown-element visas i följande bild:

Slutsats

Vim är en kraftfull editor som med hjälp av plugins blir ett ännu bättre alternativ. Vim tillhandahåller den grundläggande syntaxmarkeringen av markdown-filerna, så att de enkelt kan redigeras i redigeraren. För att förhandsgranska den renderade formen av Markdown-filen måste du dessutom installera en plugin, till exempel Vim-Instant-Markdown. Med hjälp av Linux-verktyg som Pandoc kan markdown-filer exporteras till olika filformat.