====== md2doku ======

===== Introdução =====

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 ((Sintaxe Markdown suportada: https://codeberg.org/agap/md2doku#supported-markdown-syntax)). Desse modo, os recursos específicos da Dokuwiki podem ser embutidos no conteúdo Markdown a ser  traduzido pelo programa sem ambiguidade.

===== Instalação =====

O __md2doku__ pode ser obtido por duas plataformas diferentes, ou pelo seu repositório no [[https://codeberg.org/agap/md2doku.git|Codeberg]], ou por seu espelho no [[https://git.slackjeff.com.br/agap/md2doku|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.

===== 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.

===== Referências =====

  * [[https://codeberg.org/agap/md2doku|Repositório do md2doku]]
  * [[https://git.slackjeff.com.br/agap/md2doku|Espelho do repositório do md2doku]]