Instação e uso do Pandoc

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.