Instação e uso do Pandoc

Lembrar que além do Pandoc tem o software especializado, markdown-it que converte para HTML incluindo markdowns linkados, com port para Python, resolvendo o problema como mkdocs.

---

O Pandoc é uma importante ferramenta para a gestão e registro de documentos, inclusive na Uniproof, pois garante que coisas estranhas sejam convertidas em coisas padronizadas:

• Markdown para documentação técnica em geral;
• HTML5-onlyContent para documentos oficiais.

Instalação

As instruções para Debian Linux são claras em pandoc.org/installing, mas tem uma importante pegadinha: jamais usar apt, sempre seguir a segunda recomendação, que é sudo dpkg -i $DEB. Exemplo:

wget https://github.com/jgm/pandoc/releases/download/2.9.2.1/pandoc-2.9.2.1-1-amd64.deb`
sudo dpkg -i pandoc-2.9.2.1-1-amd64.deb
pandoc --version

Uso

Usando o comando pandoc no terminal Linux.

Conversão de HTML GoogleDoc para HTML5 limpo

Tipicamente utulizaremos o GoogleDoc, que é o mais seguro e ao mesmo tempo ainda mais simples do que MS-Word, além de fazer o meio de campo com o próprio MS-Word. Basta solicitar download do formato "página Web (.html compactado)", que vai baixar um arquivo .zip, por exemplo EstatutoAfA.htm.zip.

unzip EstatutoAfA.htm.zip
pandoc -t html5  EstatutoAfA.htm  > EstatutoAfA.pandoc1.htm

No futuro outros softwares farão parsing to .pandoc1.htm. Para gerar PDF podemos usar PrinceXML ou similar.

Conversão de HTML GoogleDoc para Markdown

Ver instruções de exemplo neste link.

No caso de documentos destivados à documentação técnica, Specs, pode fazer direto, por exemplo

pandoc -f html-native_divs-native_spans -t gfm  a4a-Spec03A1-cep.html > spec03A1-cep.md