Convertendo vários arquivos de Markdown para HTML ou outros formatos no Linux

3 de abril de 2021

Muitas vezes, quando uso Markdown, trabalho em um arquivo e quando acabo com ele, eu o converto em HTML ou algum outro formato. Ocasionalmente, eu tenho que criar alguns arquivos. Quando trabalho com mais de um arquivo Markdown, geralmente espero até que eu termine antes de convertê-los.

Eu uso o pandoc para converter arquivos, e é possível converter todos os arquivos Markdown de uma vez.

Markdown pode converter seus arquivos para .html, mas se houver uma chance de ter que converter para outros formatos como o EPUB, pandoc é a ferramenta para usar. Eu prefiro usar a linha de comando, então vou cobrir isso primeiro, mas você também pode fazer isso em VSCodium sem a linha de comando. Eu vou cobrir isso também.

Convertendo vários arquivos Markdown para outro formato com pandoc [linha de comando]

Para começar rapidamente, no Ubuntu e em outras distros Debian, pode digitar os seguintes comandos no terminal:

Comandos para usar no terminal

sudo apt-get install pandoc

Neste exemplo, tenho quatro arquivos de Markdown em um diretório chamado MD_TEST.

$ ls -l *.md
-rw-r--r-- 1 bdyer bdyer 3374 Apr  7  2020 file01.md
-rw-r--r-- 1 bdyer bdyer  782 Apr  2 05:23 file02.md
-rw-r--r-- 1 bdyer bdyer 9257 Apr  2 05:21 file03.md
-rw-r--r-- 1 bdyer bdyer 9442 Apr  2 05:21 file04.md

Não há arquivos HTML ainda. Agora vou usar o pandoc para fazer sua magia na lista de arquivos. Para fazer isso, executo um comando de uma linha que:

  • Chama o pandoc.
  • Lê os arquivos .md e os exporta como .html

Este é o comando:

Comandos para usar no terminal

for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done

Se você não estiver ciente, ; é usado para executar vários comandos de uma só vez no Linux.

Veja como ficou quando eu executei o comando:

$ for i in *.md ; do echo "$i" && pandoc -s $i -o $i.html ; done
file01.md
file02.md
file03.md
file04.md

Deixe-me usar o comando ls mais uma vez para ver se os arquivos HTML foram criados:

$ ls -l *.html
-rw-r--r-- 1 bdyer bdyer  4291 Apr  2 06:08 file01.md.html
-rw-r--r-- 1 bdyer bdyer  1781 Apr  2 06:08 file02.md.html
-rw-r--r-- 1 bdyer bdyer 10272 Apr  2 06:08 file03.md.html
-rw-r--r-- 1 bdyer bdyer 10502 Apr  2 06:08 file04.md.html

A conversão foi um sucesso, e você tem quatro arquivos HTML prontos para ir no servidor da Web.

O pandoc é bastante versátil e você pode converter os arquivos Markdown para algum outro formato suportado, especificando a extensão dos arquivos de saída. Você pode entender por que é considerado entre as melhores ferramentas de código aberto para escritores.

Convertendo arquivos Markdown para HTML usando VSCodium [método GUI]

Como eu disse anteriormente, normalmente uso a linha de comando, mas nem sempre uso para conversões em lote, e você não precisa também. VSCode ou VSCodium pode fazer o trabalho. Você só precisa adicionar uma extensão, chamada: Markdown-All-in-one, que permitirá que você converta mais de um arquivo Markdown em uma execução.

Existem duas maneiras de instalar a extensão:

  • Terminal do VSCodium
  • Plugin do VSCodium

Para instalar a extensão através do terminal do VSCodium:

  1. Clique em Terminal na barra de menus. O painel terminal será aberto
  2. Digite, ou copie e cole, o seguinte comando no terminal:

Comandos para usar no terminal

codium --install-extension yzhang.markdown-all-in-one

Nota: Se você estiver usando o VSCode em vez de VSCodium, substitua a palavra, codium, no comando acima, com code.

Terminal VSCodium

A segunda maneira de instalar é através do plug-in ou extensão do VSCodium:

  1. Clique nos blocos no lado esquerdo da janela do VSCodium. Uma lista de extensões aparecerá. No topo da lista, haverá uma barra de pesquisa.

  2. Na barra de pesquisa, digite: Markdown All in One. A extensão será listada no topo da lista. Clique no botão Install para instalá-lo. Se já estiver instalado, um ícone de engrenagem aparecerá no lugar do botão de instalação.

Extensão VSCodium

Quando a extensão estiver instalada, você pode abrir a pasta que contém os arquivos Markdown que deseja converter.

Clique no ícone de papel localizado no lado esquerdo da janela do VSCodium. Você terá a oportunidade de escolher sua pasta. Quando uma pasta estiver aberta, você precisará abrir pelo menos um arquivo. Você pode abrir quantos arquivos quiser, mas um é o mínimo.

Quando um arquivo estiver aberto, traga a paleta de comando pressionando CTRL+SHIFT+P. Então, comece a digitar Markdown na barra de pesquisa que aparecerá. Enquanto você faz isso, uma lista de comandos relacionados ao markdown aparecerá. Um deles será o comando Markdown All in One: Print documents to HTML. Clique nele.

Opções de função Markdown VSCODIUM

Você será solicitado a escolher uma pasta contendo os arquivos. Um diretório de saída (chamado out) pode ser feito e é aqui que os arquivos HTML irão. A imagem abaixo mostra que o HTML foi feito após exportar os documentos Markdown. A partir daqui, você pode abrir, visualizar e editar o HTML como desejar.

VSCODIUM HTML Filelist mostrado

Por esperar para converter seus arquivos de Markdown, você pode se concentrar mais na escrita. A conversão para HTML pode vir quando você estiver pronto - e você tem duas maneiras de fazer isso.

Confira também a versão original desse post em inglês
Esse post foi originalmente publicado no site itsfoss.com. Traduzido pela rtland.team

Converting Multiple Markdown Files into HTML or Other Formats in Linux

Propaganda
Blog Comments powered by Disqus.
Propaganda