Kako stvoriti i pregledati Vim Markdown datoteke

Kako Stvoriti I Pregledati Vim Markdown Datoteke



Markdown je lagani označni jezik jednostavan za korištenje koji se koristi za oblikovanje teksta u običnoj tekstualnoj datoteci. Markdown jezik se široko koristi za stvaranje README datoteka na platformama kao što su GitHub, Trello, StackExchange i SourceForge. Nije ograničeno na stvaranje README datoteka; također se koristi za izradu web sadržaja, e-pošte i tehničke dokumentacije.

Vim se može koristiti za stvaranje, uređivanje i izvršavanje markdown datoteka izravno s terminala. Višestruki dodaci omogućuju vam da upišete markdown i uživo pregledate izlaz.

Ovaj vodič će istražiti Vimove mogućnosti za stvaranje, modificiranje i pregled markdown datoteka.







Bilješka: Za upute u ovom vodiču koristim Linux (Ubuntu 22.04).



Vim ne pregledava datoteke markdowna odmah. Zahtijeva potpunu postavku za renderiranje oznake. Da biste omogućili pregled uživo datoteka s markdownom u Vimu, potrebno je instalirati određene ovisnosti i preduvjete.



Instaliranje ovisnosti

Za pokretanje markdown datoteka pomoću Vima morate imati sljedeći program instaliran na Linuxu:





  • Node.js
  • NPM

Za instaliranje Node.js na Linux koristite:

sudo apt instalirajte nodejs

Zatim trebate instalirati Node Package Manager (npm), koristeći sljedeću naredbu:



sudo apt instalirajte npm

Za provjeru verzije Node.js koristite čvor -v naredbu i za korištenje upravitelja paketa npm -v . The npm koristi se za instaliranje mini Node.js poslužitelja koji su potrebni za različite dodatke za pretpregled Vim markdown datoteka.

Preduvjeti za pregled Vim Markdown-a

Da biste pripremili Vim za renderiranje datoteke označavanja, trebate koristiti dodatke. Najbolji način za instaliranje dodataka u Vim je korištenje Vim upravitelja dodataka. Različiti upravitelji dodataka mogu se instalirati na Vim kao što su VimPlug, Pathogen, Neobundle ili Vundle. Instaliram VimPlug, međutim, to ovisi o osobnim željama.

Instaliranje VimPlug Plugin Manager za Vim

Prvo izvršite dolje navedenu naredbu:

kovrča - fLo ~/. jer / automatsko učitavanje / utikač . jer -- stvoriti - direktoriji \

https :// sirovo . githubusercontent . s / lipnjagunn / jer - utikač / ovladati; majstorski / utikač . jer

Gornja naredba the –create-dirs stvara automatsko učitavanje imenik ako ne postoji i tamo preuzima datoteku VimPlug.

Instaliranje dodatka Markdown Live Preview

Postoji mnogo dodataka koji nude pregled datoteke markdown uživo. Popis takvih dodataka dan je u nastavku:

Svi dodaci obavljaju svoj posao vrlo učinkovito. Za ovaj vodič, instalirat ću dodatak Vim-Instant-Markdown jer on otvara preglednik za pregled datoteke uživo čim otvorite bilo koju datoteku markdown-a u Vimu.

Kliknite ovdje da biste otvorili web stranicu dodatka VimAwesome Vim-Instant-Markdown i kopirali kod za VimPlug.

Otvorite datoteku vimrc datoteku sa sudo privilegijama:

sudo vim / itd / jer / vimrc

Pa, nije preporučljivo uređivati ​​sistemske datoteke, stoga stvorite vimrc datoteku specifičnu za korisnika pomoću sljedeće naredbe.

jer ~/. vimrc

Postavite sljedeće retke u datoteku.

poziv utikač#početak ( )

Utikač 'suan/vim-instant-markdown'

poziv čep#kraj ( )

Možete instalirati bilo koji dodatak postavljanjem koda dodatka između call plug#begin() i poziv plug#end() oznake u datoteci vimrc. Spremite datoteku pomoću tipki SHIFT+zz ili upotrijebite naredbu :wq u Vim naredbenom modu.

Sada otvorite Vim editor pomoću jer zapovjedi i trči :PlugInstall u zapovjednom načinu rada.

: PlugInstall

Instalirat će dodatak i spremni ste za stvaranje datoteke označavanja i njezin pretpregled uživo u Vim uređivaču.

Stvaranje Markdown datoteke u Vimu

Najnoviji Vim nudi isticanje sintakse datoteke markdown odmah.

Da biste stvorili datoteku označavanja u Vimu, koristite sljedeću sintaksu:

jer [ naziv datoteke ] . doktor medicine

Možete koristiti različite ekstenzije za markdown datoteku, kao što su:

  • doktor medicine
  • mkd
  • smanjenje

Kreirajmo datoteku za označavanje.

# DOBRO DOŠLI

** Ovaj je Linux **

> Web stranica koja nudi upute vezane uz do Linux i otvoren - izvorni softver .

## Popularne kategorije

1 . Ubuntu

2 . Linux naredbe

3 . Zašto

### Naredba do Instalirajte Node . js na Linux

`sudo apt install nodejs`

### Java Hello World Code

```

klasa HelloWorld {

public static void main ( Niz [ ] args ) {

Sustav . van . println ( 'Pozdrav svijete!' ) ;

}

}

```

Posjetiti [ Linux ] ( www . linuxhint . s ) Sada !

U gornjoj datoteci, znakovi hash (#, ##, ###) koriste se za dodavanje naslova s ​​različitim težinama, simbol veće od (>) koristi se za dodavanje navodnika, a koriste se kvačice (`, “`). da biste dodali naredbe ili blokove koda, za više elemenata datoteke markdown pogledajte varalicu u sljedećem odjeljku.

Pregled Vim Markdown datoteke

Da biste vidjeli datoteku markdown, potreban vam je renderer koji može prevesti datoteku i dati izlaz prema uputama. Baš kao i HTML datoteka za koju je potreban web-preglednik da bi je prikazao, markdown datoteka također treba aplikaciju za pregled.

Dostupne su mnoge aplikacije za iscrtavanje koje mogu vidjeti datoteku markdowna, za ovaj smo vodič instalirali dodatak za Vim koji nam može pomoći da uživo pregledamo datoteku markdowna.

Dakle, kada otvorite bilo koju datoteku markdowna, dodatak Vim-Instant-Markdown otvara preglednik za prikaz uživo renderirane verzije datoteke markdowna u Vimu.

Dok uređujete datoteku u Vimu, dodatak će prevesti upute o vremenu izvođenja i dati pregled uživo u pregledniku.

Pregled Vim Markdown-a u terminalu

Markdown datoteke mogu se čitati u terminalu pomoću različitih markdown renderera kao što su Pandoc ili Glow. Instalirajmo Glow, koristeći Snap na Linux:

sudo snap install glow

Sada, da biste vidjeli markdown datoteku u terminalu koristite:

sjaj [ naziv datoteke ] . doktor medicine

Međutim, ti čitači tumače samo ograničeni broj Markdown elemenata i možda neće podržavati sve značajke. Po mom mišljenju, gledanje markdowna s terminala nije dobar izbor.

Izvoz Markdown datoteke u različite formate pomoću Vima

Dobra značajka markdown datoteka je da ih možete izvesti u različite formate datoteka kao što su dokumenti, PDF-ovi i HTML. Za to morate instalirati uslužni program pandoc.

Da biste instalirali pandoc na Linux, koristite:

sudo apt - dobiti instalirajte pandoc texlive - lateks - baza texlive - fontovi - preporučeni texlive - ekstra - koristi texlive - lateks - ekstra

Za PDF pretvorbu možda će vam trebati dodatni uslužni programi spomenuti u gornjoj naredbi.

Bilješka: Provjerite jeste li spremili datoteku prije nego što izvršite naredbe za izvoz datoteka markdowna u drugi format.

Pretvaranje Markdown datoteke u HTML

Upotrijebite naredbu danu u nastavku za pretvaranje datoteke markdowna u HTML.

Bilješka: Korištenje ! znak bilo koja vanjska naredba može se izvršiti u Vim editoru.

:! pandoc [ naziv datoteke ] . doktor medicine - O [ naziv datoteke ] . html

Pretvaranje Markdown datoteke u PDF

PDF je široko prihvaćen format datoteke; da biste pretvorili markdown datoteku u PDF upotrijebite dolje navedenu naredbu:

:! pandoc [ naziv datoteke ] . doktor medicine - O [ naziv datoteke ] . pdf

Pretvaranje Markdown datoteke u Docx

Docx je još jedan format datoteke koji se može pretvoriti u markdown datoteku.

:! pandoc [ naziv datoteke ] . doktor medicine - O [ naziv datoteke ] . docx

Zamijenite [naziv datoteke] u gornjim naredbama s nazivima datoteka koje želite pretvoriti.

Markdown Cheat Sheet

Često korišteni elementi označavanja dati su na sljedećoj slici:

Zaključak

Vim je moćan editor koji uz pomoć dodataka postaje još bolja opcija. Vim pruža osnovno isticanje sintakse markdown datoteka, tako da se mogu lako uređivati ​​u uređivaču. Osim toga, da biste pregledali prikazani oblik Markdown datoteke, trebate instalirati dodatak, kao što je Vim-Instant-Markdown. Uz pomoć Linux uslužnih programa kao što je pandoc markdown datoteke mogu se izvesti u različite formate datoteka.