Com crear i previsualitzar fitxers Vim Markdown

Com Crear I Previsualitzar Fitxers Vim Markdown



Markdown és un llenguatge de marques lleuger i fàcil d'utilitzar que s'utilitza per formatar text en un fitxer de text senzill. El llenguatge Markdown s'utilitza àmpliament per crear fitxers README a plataformes com GitHub, Trello, StackExchange i SourceForge. No es limita a crear fitxers README; també s'utilitza per crear contingut web, correus electrònics i documentació tècnica.

Vim es pot utilitzar per crear, editar i executar fitxers de marcatge directament des del terminal. Diversos connectors us permeten escriure la reducció i visualitzar en directe la sortida.

Aquesta guia explorarà les capacitats de Vim per crear, modificar i previsualitzar fitxers de marcatge.







Nota: Per a les instruccions d'aquest tutorial, estic fent servir Linux (Ubuntu 22.04).



Vim no previsualitza els fitxers de marcatge fora de la caixa. Requereix una configuració completa per renderitzar el fitxer de marcatge. Per habilitar la previsualització en directe dels fitxers de marcatge a Vim, cal instal·lar determinades dependències i requisits previs.



Instal·lació de les dependències

Per executar els fitxers de marcatge amb Vim, necessiteu tenir el següent programa instal·lat a Linux:





  • Node.js
  • NPM

Per instal·lar Node.js a Linux, feu servir:

sudo apt install nodejs

Aleshores, heu d'instal·lar el Gestor de paquets de nodes (npm), mitjançant l'ordre següent:



sudo apt install npm

Per verificar la versió de Node.js, utilitzeu el node -v comanda i per a l'ús del gestor de paquets npm -v . El npm s'utilitza per instal·lar mini servidors Node.js que són necessaris per a diferents connectors de visualització prèvia de fitxers de marcatge de Vim.

Requisits previs per veure Vim Markdown

Per preparar Vim per a la representació del fitxer Markdown, heu d'utilitzar els connectors. La millor manera d'instal·lar els connectors a Vim és utilitzar el gestor de connectors de Vim. Es poden instal·lar diversos gestors de connectors a Vim, com ara VimPlug, Pathogen, Neobundle o Vundle. Estic instal·lant el VimPlug, però, depèn de les preferències personals.

Instal·lació del Gestor de connectors de VimPlug per a Vim

Primer, executeu l'ordre esmentada a continuació:

rínxol - fLo ~/. perquè / càrrega automàtica / endoll . perquè -- crear - dirs \

https :// crua . githubusercontent . amb / Junegunn / perquè - endoll / mestre / endoll . perquè

L'ordre anterior el –crear-dirs crea el càrrega automàtica directori si no existeix i hi descarrega el fitxer VimPlug.

Instal·lació del connector Markdown Live Preview

Hi ha molts connectors que ofereixen una vista prèvia en directe del fitxer de reducció. A continuació es mostra una llista d'aquests connectors:

Tots els connectors fan la seva feina de manera molt eficient. Per a aquest tutorial, instal·laré el connector Vim-Instant-Markdown perquè obre el navegador per visualitzar en directe el fitxer tan aviat com obriu qualsevol fitxer de remarcació a Vim.

Feu clic aquí per obrir la pàgina web del complement VimAwesome Vim-Instant-Markdown i copieu el codi de VimPlug.

Obriu el fitxer vimrc amb privilegis sudo:

sudo vim / etc / perquè / vimrc

Bé, no es recomana editar els fitxers del sistema, per tant, creeu un fitxer vimrc específic de l'usuari mitjançant l'ordre següent.

perquè ~/. vimrc

Col·loqueu les línies següents al fitxer.

anomenada connector#begin ( )

Endoll 'suan/vim-instant-markdown'

anomenada connector #extrem ( )

Podeu instal·lar qualsevol connector col·locant el codi del connector entre trucada endoll#begin() i trucada endoll#end() etiquetes al fitxer vimrc. Deseu el fitxer amb les tecles MAJ+zz o utilitzeu l'ordre :wq en el mode d'ordres Vim.

Ara, obriu l'editor de Vim amb el perquè mana i corre :PlugInstall en mode de comandament.

: PlugInstall

Instal·larà el connector i ja esteu preparat per crear el fitxer de reducció i previsualitzar-lo en directe a l'editor Vim.

Creació d'un fitxer Markdown a Vim

L'últim Vim ofereix un ressaltat de sintaxi de fitxers de marcatge fora de la caixa.

Per crear el fitxer Markdown a Vim, utilitzeu la sintaxi següent:

perquè [ nom de l'arxiu ] . md

Podeu utilitzar diferents extensions per a un fitxer de reducció, com ara:

  • md
  • mkd
  • rebaixa

Creem un fitxer de reducció.

# BENVINGUT

** Això és Linux **

> Un lloc web que ofereix tutorials relacionats a Linux i obert - programari font .

## Categories populars

1 . Ubuntu

2 . Ordres de Linux

3 . Per què

### Comandament a Instal·leu Node . js activat Linux

`sudo apt install nodejs`

### Java Hello World Code

````

classe HelloWorld {

principal buit estàtic públic ( Corda [ ] args ) {

Sistema . fora . imprimirln ( 'Hola món!' ) ;

}

}

````

Visita [ Linux ] ( www . linuxhint . amb ) Ara !

Al fitxer anterior, els signes hash (#, ##, ###) s'utilitzen per afegir encapçalaments amb diferents pesos, el símbol més gran que (>) s'utilitza per afegir una cita de bloc i s'utilitzen ticks (`, '`) per afegir les ordres o els blocs de codi, per obtenir més elements del fitxer de reducció, consulteu el full de trucs a la secció següent.

Vista prèvia del fitxer Vim Markdown

Per veure el fitxer de reducció, necessiteu un renderitzador que pugui traduir el fitxer i proporcionar la sortida segons les instruccions. Igual que un fitxer HTML que requereix un navegador web per representar-lo, un fitxer de marcatge també necessita una aplicació per visualitzar-lo.

Hi ha moltes aplicacions de renderitzador disponibles que poden veure un fitxer de reducció, per a aquest tutorial hem instal·lat un connector de Vim que ens pot ajudar a previsualitzar en directe el fitxer de reducció.

Per tant, quan obriu qualsevol fitxer de reducció, el connector Vim-Instant-Markdown obre el navegador a una versió de visualització prèvia en directe del fitxer de reducció a Vim.

A mesura que editeu el fitxer a Vim, el connector traduirà les instruccions en temps d'execució i donarà una vista prèvia en directe al navegador.

Vista prèvia del Vim Markdown a la terminal

Els fitxers de marcatge es poden llegir al terminal mitjançant diferents representadors de marcatge com Pandoc o Glow. Instal·lem Glow, utilitzant Snap a Linux:

sudo snap install glow

Ara, per veure un fitxer de reducció al terminal, utilitzeu:

brillar [ nom de l'arxiu ] . md

No obstant això, aquests lectors només interpreten un nombre limitat d'elements Markdown i poden no admetre totes les funcions. Al meu entendre, veure la reducció des del terminal no és una bona opció.

Exportant el fitxer Markdown a diferents formats amb Vim

Una bona característica dels fitxers de reducció és que els podeu exportar a diferents formats de fitxer, com ara documents, PDF i HTML. Per això, cal instal·lar una utilitat anomenada pandoc.

Per instal·lar el pandoc a Linux, utilitzeu:

sudo apt - aconseguir instal·lar pandoc texlive - làtex - base de texlive - tipus de lletra - recomanat texlive - extra - utils texlive - làtex - extra

Per a la conversió de PDF, és possible que necessiteu les utilitats addicionals esmentades a l'ordre anterior.

Nota: Assegureu-vos de desar el fitxer abans d'executar ordres per exportar els fitxers de reducció a un format diferent.

Convertir un fitxer Markdown a HTML

Utilitzeu l'ordre que es mostra a continuació per convertir un fitxer de reducció a HTML.

Nota: Utilitzant ! signar qualsevol comanda externa es pot executar a l'editor Vim.

:! pandoc [ nom de l'arxiu ] . md - O [ nom de l'arxiu ] . html

Convertir un fitxer Markdown a PDF

PDF és un format de fitxer àmpliament acceptat; per convertir un fitxer de reducció en un PDF, utilitzeu l'ordre esmentada a continuació:

:! pandoc [ nom de l'arxiu ] . md - O [ nom de l'arxiu ] . pdf

Conversió d'un fitxer Markdown a Docx

Docx és un altre format de fitxer que es pot convertir en un fitxer de reducció.

:! pandoc [ nom de l'arxiu ] . md - O [ nom de l'arxiu ] . docx

Substituïu el [nom de l'arxiu] a les ordres anteriors amb els noms de fitxer que voleu convertir.

Full de trucs de Markdown

Els elements de reducció d'ús habitual es mostren a la imatge següent:

Conclusió

Vim és un editor potent que amb l'ajuda de connectors es converteix en una opció encara millor. Vim proporciona el ressaltat de sintaxi bàsica dels fitxers de reducció, de manera que es poden editar fàcilment a l'editor. A més, per previsualitzar la forma renderitzada del fitxer Markdown, heu d'instal·lar un connector, com ara Vim-Instant-Markdown. Amb l'ajuda de les utilitats de Linux, com ara els fitxers Pandoc Markdown, es poden exportar a diferents formats de fitxer.