Como criar e visualizar arquivos Markdown do Vim

Como Criar E Visualizar Arquivos Markdown Do Vim



Markdown é uma linguagem de marcação leve e fácil de usar usada para formatar texto em um arquivo de texto simples. A linguagem Markdown é amplamente usada para criar arquivos README em plataformas como GitHub, Trello, StackExchange e SourceForge. Não se limita à criação de arquivos README; também é usado para criar conteúdo da web, e-mails e documentação técnica.

O Vim pode ser usado para criar, editar e executar arquivos markdown diretamente do terminal. Vários plug-ins permitem que você digite o markdown e visualize a saída ao vivo.

Este guia explorará os recursos do Vim para criar, modificar e visualizar arquivos markdown.







Observação: Para obter as instruções deste tutorial, estou usando Linux (Ubuntu 22.04).



O Vim não visualiza os arquivos markdown imediatamente. Requer uma configuração completa para renderizar o arquivo de marcação. Para habilitar a visualização ao vivo de arquivos markdown no Vim, certas dependências e pré-requisitos precisam ser instalados.



Instalando as Dependências

Para executar os arquivos markdown usando o Vim você precisa ter o seguinte programa instalado no Linux:





  • Node.js
  • NPM

Para instalar o Node.js no Linux, use:

sudo apt instalar nodejs

Então você precisa instalar o Node Package Manager (npm), usando o seguinte comando:



sudo apt instalar npm

Para verificar a versão do Node.js, use o nó -v comando e para o uso do gerenciador de pacotes npm -v . O npm é usado para instalar mini servidores Node.js que são necessários para diferentes plug-ins de visualização de arquivos markdown do Vim.

Pré-requisitos para visualizar o Markdown do Vim

Para preparar o Vim para renderizar o arquivo markdown você precisa usar os plugins. A melhor maneira de instalar os plugins no Vim é usando o gerenciador de plugins do Vim. Vários gerenciadores de plugins podem ser instalados no Vim, como VimPlug, Pathogen, Neobundle ou Vundle. Estou instalando o VimPlug, porém fica a critério pessoal.

Instalando o VimPlug Plugin Manager para Vim

Primeiro, execute o comando mencionado abaixo:

ondulação - fLo ~/. porque / carregamento automático / plugue . porque -- criar - dirs \

https // cru . githubusercontent . com / junho / porque - plugue / mestre / plugue . porque

O comando acima –criar-dirs cria o carregamento automático diretório se ele não existir e baixa o arquivo VimPlug lá.

Instalando o plug-in Markdown Live Preview

Existem muitos plug-ins que oferecem uma visualização ao vivo do arquivo markdown. Uma lista desses plug-ins é fornecida abaixo:

Todos os plugins fazem seu trabalho com muita eficiência. Para este tutorial, instalarei o plugin Vim-Instant-Markdown porque ele abre o navegador para visualizar o arquivo ao vivo assim que você abre qualquer arquivo markdown no Vim.

Clique aqui para abrir a página do plugin VimAwesome Vim-Instant-Markdown e copiar o código do VimPlug.

Abra o arquivo vimrc com privilégios sudo:

sudo vim / etc. / porque / vimrc

Bem, não é recomendado editar os arquivos do sistema, portanto, crie um arquivo vimrc específico do usuário usando o seguinte comando.

porque ~/. vimrc

Coloque as seguintes linhas no arquivo.

chamar plug#begin ( )

Plugue 'suan/vim-remarcação instantânea'

chamar plug#fim ( )

Você pode instalar qualquer plugin colocando o código do plugin entre chamar plug#begin() e chamar plug#end() tags no arquivo vimrc. Salve o arquivo usando as teclas SHIFT+zz ou use o comando :wq no modo de comando do Vim.

Agora, abra o editor Vim usando o porque comandar e executar :PlugInstall no modo de comando.

: PlugInstall

Ele instalará o plugin e você estará pronto para criar o arquivo markdown e visualizá-lo ao vivo no editor Vim.

Criando um arquivo Markdown no Vim

O Vim mais recente fornece realce de sintaxe de arquivo markdown pronto para uso.

Para criar o arquivo markdown no Vim, use a seguinte sintaxe:

porque [ nome do arquivo ] . médico

Você pode usar extensões diferentes para um arquivo markdown, como:

  • médico
  • mkd
  • redução

Vamos criar um arquivo markdown.

# BEM-VINDO

** Esse é Linux **

> Um site que oferece tutoriais relacionados para Linux e aberto - software de origem .

## Categorias populares

1 . Ubuntu

2 . Comandos Linux

3 . Por que

### Comando para Instalar nó . js sobre Linux

`sudo apt instalar nodejs`

### Java Olá Código Mundial

```

classe Olá Mundo {

público estático vazio principal ( Corda [ ] argumentos ) {

Sistema . fora . imprimir ( 'Olá Mundo!' ) ;

}

}

```

Visita [ Linux ] ( www . linuxhint . com ) Agora !

No arquivo acima, os sinais de hash (#, ##, ###) são usados ​​para adicionar títulos com pesos diferentes. O símbolo maior que (>) é usado para adicionar aspas em bloco e os tiques (`, “`) são usados para adicionar os comandos ou blocos de código, para obter mais elementos do arquivo markdown, consulte a folha de dicas na seção a seguir.

Visualizando o arquivo Markdown do Vim

Para visualizar o arquivo markdown, você precisa de um renderizador que possa traduzir o arquivo e fornecer a saída conforme as instruções. Assim como um arquivo HTML que requer um navegador da web para renderizá-lo, um arquivo markdown também precisa de um aplicativo para visualizá-lo.

Existem muitos aplicativos de renderização disponíveis que podem visualizar um arquivo markdown. Para este tutorial, instalamos um plug-in Vim que pode nos ajudar a visualizar ao vivo o arquivo markdown.

Portanto, quando você abre qualquer arquivo markdown, o plug-in Vim-Instant-Markdown abre o navegador para uma versão renderizada de visualização ao vivo do arquivo markdown no Vim.

Conforme você edita o arquivo no Vim, o plugin irá traduzir as instruções em tempo de execução e fornecer uma visualização ao vivo no navegador.

Visualizando o Markdown do Vim no Terminal

Os arquivos markdown podem ser lidos no terminal usando diferentes renderizadores markdown, como Pandoc ou Glow. Vamos instalar o Glow, usando Snap no Linux:

sudo snap install brilho

Agora, para visualizar um arquivo markdown no terminal, use:

brilho [ nome do arquivo ] . médico

No entanto, esses leitores interpretam apenas um número limitado de elementos do Markdown e podem não suportar todos os recursos. Na minha opinião, visualizar a redução no terminal não é uma boa escolha.

Exportando o arquivo Markdown para diferentes formatos usando Vim

Um bom recurso dos arquivos markdown é que você pode exportá-los para diferentes formatos de arquivo, como documentos, PDFs e HTML. Para isso, você precisa instalar um utilitário chamado pandoc.

Para instalar o pandoc no Linux, use:

sudo apto - pegar instalar pandoc texlive - látex - base texlive - fontes - texlive recomendado - extra - utilitários texlive - látex - extra

Para conversão de PDF você pode precisar de utilitários extras mencionados no comando acima.

Observação: Certifique-se de salvar o arquivo antes de executar comandos para exportar os arquivos markdown para um formato diferente.

Convertendo um arquivo Markdown em HTML

Use o comando fornecido a seguir para converter um arquivo markdown em HTML.

Observação: Usando ! assinar qualquer comando externo pode ser executado no editor Vim.

:! pandoc [ nome do arquivo ] . médico - o [ nome do arquivo ] . HTML

Convertendo um arquivo Markdown em PDF

PDF é um formato de arquivo amplamente aceito; para converter um arquivo markdown em PDF, use o comando mencionado abaixo:

:! pandoc [ nome do arquivo ] . médico - o [ nome do arquivo ] . pdf

Convertendo um arquivo Markdown em Docx

Docx é outro formato de arquivo em que um arquivo markdown pode ser convertido.

:! pandoc [ nome do arquivo ] . médico - o [ nome do arquivo ] . docx

Substitua o [nome do arquivo] nos comandos acima com os nomes dos arquivos que você deseja converter.

Folha de dicas de redução

Os elementos de marcação comumente usados ​​são fornecidos na imagem a seguir:

Conclusão

Vim é um editor poderoso que com a ajuda de plugins se torna uma opção ainda melhor. O Vim fornece o destaque de sintaxe básico dos arquivos markdown, para que possam ser facilmente editados no editor. Além disso, para visualizar a forma renderizada do arquivo Markdown, você precisa instalar um plugin, como Vim-Instant-Markdown. Com a ajuda de utilitários Linux, como pandoc, os arquivos markdown podem ser exportados para diferentes formatos de arquivo.