O md2doku (pronunciado por seu autor como emdí tsú dôku) é um conversor de Markdown para a sintaxe de formatação da Dokuwiki.
Inicialmente, ele foi desenvolvido para facilitar contribuições nesta Wiki a adeptos do Markdown, sem a necessidade de conferir periodicamente a referência de sintaxe básica da Dokuwiki e de aprender funcionalidades da Dokuwiki já existentes no Markdown.
A fim de aumentar sua simplicidade, o md2doku suporta atualmente apenas as funcionalidades em comum entre as duas sintaxes 1). Desse modo, os recursos específicos da Dokuwiki podem ser embutidos no conteúdo Markdown a ser traduzido pelo programa sem ambiguidade.
O md2doku pode ser obtido por duas plataformas diferentes, ou pelo seu repositório no Codeberg, ou por seu espelho no Forgejo da comunidade. Em ambas as plataformas, o md2doku pode ser baixado como um pacote “.zip” ou clonado pelo git:
$ git clone https://git.slackjeff.com.br/agap/md2doku
Depois de baixado e, se necessário, extraído, o script md2doku localizado dentro do diretório baixado de mesmo nome pode ser copiado para um diretório incluso na variável PATH a fim de ser invocado facilmente pelo shell em uso.
Estando o md2doku devidamente instalado, há duas formas de usá-lo: pelo stdin ou por arquivos fornecidos por linha de comando, como sugerem os exemplos a seguir.
$ cat arquivo_markdown.md | md2doku # uso pelo stdin $ md2doku arq0.md arq1.md arq2.md ... arqN.md # uso por argumento
Até este momento sob desenvolvimento, o md2doku “imprime” no stdout o conteúdo convertido em sintaxe da Dokuwiki.