Instação e uso do Pandoc

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

• Markdown para documentação técnica em geral;
• [HTML5-onlyContent(https://github.com/okfn-brasil/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.

Uso

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.

Conversão de HTML GoogleDoc para Markdown

Ver instruções de exemplo neste link.