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 a contribuições nesta Wiki a de 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 ¹⁾. 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

Por padrão, o md2doku “imprime” no stdout o conteúdo convertido em sintaxe da Dokuwiki.

• Repositório do __md2doku__
• Espelho do repositório do __md2doku__