Vim možno použiť na vytváranie, úpravu a spúšťanie súborov markdown priamo z terminálu. Viaceré doplnky vám umožňujú zadať značku a zobraziť živý náhľad výstupu.
Táto príručka preskúma možnosti Vim vytvárať, upravovať a zobrazovať ukážky súborov so značkami.
- Inštalácia závislostí
- Predpoklady na zobrazenie ukážky Vim Markdown
- Inštalácia VimPlug Plugin Manager pre Vim
- Inštalácia doplnku Markdown Live Preview
- Vytvorenie súboru Markdown vo Vime
- Zobrazenie ukážky súboru Vim Markdown
- Ukážka Vim Markdown v termináli
- Export súboru Markdown do rôznych formátov pomocou Vim
- Markdown Cheat Sheet
- Záver
Poznámka: Pre pokyny v tomto návode používam Linux (Ubuntu 22.04).
Vim nezobrazuje ukážku súborov markdown po vybalení. Na vykreslenie súboru značiek je potrebné úplné nastavenie. Ak chcete povoliť živý náhľad súborov markdown vo Vime, je potrebné nainštalovať určité závislosti a predpoklady.
Inštalácia závislostí
Ak chcete spustiť súbory markdown pomocou Vim, musíte mať v systéme Linux nainštalovaný nasledujúci program:
- Node.js
- NPM
Ak chcete nainštalovať Node.js v systéme Linux, použite:
sudo apt install nodejsPotom musíte nainštalovať správcu balíkov uzlov (npm) pomocou nasledujúceho príkazu:
sudo apt install npm
Na overenie verzie Node.js použite súbor uzol -v príkaz a na použitie správcu balíkov npm -v . The npm sa používa na inštaláciu mini serverov Node.js, ktoré sú potrebné pre rôzne doplnky na zobrazenie náhľadu súborov Vim markdown.
Predpoklady na zobrazenie Vim Markdown
Ak chcete pripraviť Vim na vykreslenie súboru markdown, musíte použiť doplnky. Najlepší spôsob, ako nainštalovať doplnky do Vimu, je použiť správcu doplnkov Vim. Na Vim je možné nainštalovať rôznych správcov doplnkov, ako napríklad VimPlug, Pathogen, Neobundle alebo Vundle. Inštalujem VimPlug, je to však na osobných preferenciách.
Inštalácia VimPlug Plugin Manager pre Vim
Najprv vykonajte príkaz uvedený nižšie:
zvlniť - fLo ~/. pretože / automatické načítanie / zástrčka . pretože -- vytvoriť - adresár \https :// surové . obsah githubu . s / junegunn / pretože - zástrčka / majster / zástrčka . pretože
Vyššie uvedený príkaz the –vytvoriť adresár vytvára automatické načítanie adresár, ak neexistuje a stiahne tam súbor VimPlug.
Inštalácia doplnku Markdown Live Preview
Existuje veľa doplnkov, ktoré ponúkajú živý náhľad súboru markdown. Zoznam takýchto doplnkov je uvedený nižšie:
Všetky pluginy vykonávajú svoju prácu veľmi efektívne. Pre tento tutoriál nainštalujem doplnok Vim-Instant-Markdown, pretože otvorí prehliadač, aby si mohol zobraziť živý náhľad súboru hneď, ako otvoríte akýkoľvek súbor markdown vo Vime.
Kliknutím sem otvoríte webovú stránku doplnku VimAwesome Vim-Instant-Markdown a skopírujete kód pre VimPlug.
Otvorte súbor vimrc s oprávneniami sudo:
sudo vim / atď / pretože / vimrcNeodporúča sa upravovať systémové súbory, preto vytvorte súbor vimrc špecifický pre používateľa pomocou nasledujúceho príkazu.
pretože ~/. vimrcDo súboru vložte nasledujúce riadky.
hovor zástrčka#začať ( )Zástrčka 'suan/vim-instant-markdown'
hovor plug#end ( )
Môžete nainštalovať ľubovoľný doplnok umiestnením kódu doplnku medzi konektor hovoru#begin() a call plug#end() tagy v súbore vimrc. Uložte súbor pomocou klávesov SHIFT+zz alebo použite príkaz :wq v príkazovom režime Vim.
Teraz otvorte editor Vim pomocou pretože prikázať a spustiť :PlugInstall v príkazovom režime.
: PlugInstallNainštaluje doplnok a všetko je pripravené na vytvorenie súboru markdown a jeho živý náhľad v editore Vim.
Vytvorenie súboru Markdown vo Vime
Najnovší Vim poskytuje zvýraznenie syntaxe súboru markdown hneď po vybalení.
Ak chcete vytvoriť súbor markdown vo Vime, použite nasledujúcu syntax:
pretože [ názov súboru ] . mdPre súbor markdown môžete použiť rôzne prípony, ako napríklad:
- md
- mkd
- markdown
Vytvorme súbor markdown.
# VÍTAJTE** Toto je Linux **
> Web, ktorý ponúka súvisiace návody do Linux a otvorený - zdrojový softvér .
## Obľúbené kategórie
1 . Ubuntu
2 . Linuxové príkazy
3 . Prečo?
### Príkaz do Nainštalujte Node . js na Linux
`sudo apt install nodejs`
### Java Hello World Code
```
trieda HelloWorld {
public static void main ( Reťazec [ ] args ) {
systém . von . println ( 'Ahoj Svet!' ) ;
}
}
```
Navštívte [ Linux ] ( www . linuxhint . s ) Teraz !
Vo vyššie uvedenom súbore sa znaky hash (#, ##, ###) používajú na pridávanie nadpisov s rôznou váhou, symbol väčší ako (>) sa používa na pridávanie blokových úvodzoviek a používajú sa značky (`, “`) ak chcete pridať príkazy alebo bloky kódu, ďalšie prvky súboru markdown nájdete v cheat sheet v nasledujúcej časti.
Zobrazenie ukážky súboru Vim Markdown
Na zobrazenie súboru markdown potrebujete renderer, ktorý dokáže preložiť súbor a poskytnúť výstup podľa pokynov. Rovnako ako súbor HTML, ktorý na vykreslenie vyžaduje webový prehliadač, aj súbor markdown potrebuje aplikáciu na jeho zobrazenie.
Existuje veľa aplikácií na vykresľovanie, ktoré dokážu zobraziť súbor markdown, pre tento tutoriál sme nainštalovali doplnok Vim, ktorý nám môže pomôcť zobraziť náhľad súboru markdown.
Takže, keď otvoríte akýkoľvek súbor markdown, doplnok Vim-Instant-Markdown otvorí prehliadač a zobrazí verziu živého náhľadu vykreslenú súborom markdown vo Vime.
Keď upravujete súbor vo Vime, doplnok preloží pokyny na runtime a poskytne živý náhľad v prehliadači.
Ukážka Vim Markdown v termináli
Súbory markdown je možné čítať v termináli pomocou rôznych rendererov markdown, ako sú Pandoc alebo Glow. Nainštalujeme Glow pomocou aplikácie Snap v systéme Linux:
žiara inštalácie sudo snapAk chcete teraz zobraziť súbor markdown v termináli, použite:
žiara [ názov súboru ] . md 
Tieto čítačky však interpretujú iba obmedzený počet prvkov Markdown a nemusia podporovať všetky funkcie. Podľa môjho názoru nie je sledovanie markdown z terminálu dobrou voľbou.
Export súboru Markdown do rôznych formátov pomocou Vim
Dobrou vlastnosťou súborov markdown je, že ich môžete exportovať do rôznych formátov súborov, ako sú dokumenty, PDF a HTML. Na to musíte nainštalovať nástroj s názvom pandoc.
Ak chcete nainštalovať pandoc v systéme Linux, použite:
sudo apt - dostať nainštalovať pandoc texlive - latex - base texlive - fonty - odporúčané texlive - extra - utils texlive - latex - extraNa konverziu PDF možno budete potrebovať ďalšie nástroje uvedené vo vyššie uvedenom príkaze.
Poznámka: Pred spustením príkazov na export súborov markdown do iného formátu nezabudnite súbor uložiť.
Konverzia súboru Markdown do HTML
Pomocou príkazu uvedeného nižšie skonvertujte súbor markdown do HTML.
Poznámka: Použitím ! podpísať akýkoľvek externý príkaz je možné vykonať v editore Vim.
:! pandoc [ názov súboru ] . md - O [ názov súboru ] . html 
Konverzia súboru Markdown do formátu PDF
PDF je široko akceptovaný formát súboru; na konverziu súboru markdown do PDF použite príkaz uvedený nižšie:
:! pandoc [ názov súboru ] . md - O [ názov súboru ] . pdf 
Konverzia súboru Markdown na Docx
Docx je ďalší formát súboru, ktorý je možné skonvertovať.
:! pandoc [ názov súboru ] . md - O [ názov súboru ] . docx 
Vymeňte [názov súboru] vo vyššie uvedených príkazoch s názvami súborov, ktoré chcete previesť.
Markdown Cheat Sheet
Bežne používané značkovacie prvky sú uvedené na nasledujúcom obrázku:
Záver
Vim je výkonný editor, ktorý sa pomocou doplnkov stáva ešte lepšou voľbou. Vim poskytuje základné zvýraznenie syntaxe súborov markdown, takže ich možno ľahko upravovať v editore. Ak chcete zobraziť ukážku vykreslenej formy súboru Markdown, musíte si nainštalovať doplnok, napríklad Vim-Instant-Markdown. Pomocou linuxových nástrojov, ako sú napríklad súbory pandoc markdown, je možné exportovať do rôznych formátov súborov.