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:
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:
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:
- Clique em
Terminal
na barra de menus. O painel terminal será aberto - Digite, ou copie e cole, o seguinte comando 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
.
A segunda maneira de instalar é através do plug-in ou extensão do VSCodium:
-
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.
-
Na barra de pesquisa, digite:
Markdown All in One
. A extensão será listada no topo da lista. Clique no botãoInstall
para instalá-lo. Se já estiver instalado, um ícone de engrenagem aparecerá no lugar do botão de instalação.
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.
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.
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.
Via itsfoss.com. Você pode conferir o post original em inglês:
Converting Multiple Markdown Files into HTML or Other Formats in LinuxÚltima atualização deste artigo: 3 de april de 2021