MD2Doc By Christopher N. S. M. Mauricio .'.

MD2Doc

Conversor visual de Markdown para DOCX, HTML e Markdown usando pandoc.exe, com interface em Tkinter, suporte a template .docx, modo lote, modo unificado e execução portátil.

Visão geral

O MD2Doc foi pensado para facilitar a conversão de documentos Markdown em um fluxo visual, simples e portátil. Ele atende tanto o uso individual quanto cenários com múltiplos arquivos, preservando a praticidade de selecionar arquivos, escolher pasta de saída, aplicar template e acompanhar logs de execução.

Navegação rápida

• 📘 Manual do usuário
• ⚙️ Guia técnico
• 🏗️ Build do executável
• 🐞 Debug e execução

Principais recursos

• Interface gráfica em Tkinter
• Seleção de arquivo único ou pasta inteira
• Conversão individual em lote
• Modo de unificação de vários arquivos em um só documento
• Suporte a template .docx via Pandoc
• Persistência de preferências do usuário
• Logs em arquivo para suporte e debug
• Estrutura preparada para build com PyInstaller
• Distribuição portable já preparada em dist/MD2Doc.zip

Estrutura do projeto

MD2Doc/
├─ app.py
├─ requirements.txt
├─ .env.example
├─ md2doc.spec
├─ build_tools/
│  └─ build_pyinstaller.ps1
├─ README.md
├─ docs/
│  ├─ BUILD.md
│  ├─ DEBUG_E_EXECUCAO.md
│  ├─ DOCUMENTACAO_TECNICA.md
│  └─ MANUAL_USUARIO.md
├─ assets/
│  ├─ icons/
│  └─ templates/
├─ bin/
│  └─ pandoc.exe
├─ config/
├─ logs/
├─ output/
├─ models/
├─ services/
├─ ui/
└─ utils/

Requisitos

• Python 3.11+ recomendado
• Windows recomendado para o fluxo com pandoc.exe
• Dependências do requirements.txt

Instalação para desenvolvimento

pip install -r requirements.txt

Configuração de ambiente

1. Copie .env.example para .env
2. Ajuste os valores conforme a necessidade

Exemplo:

MD2DOC_DEBUG=true
MD2DOC_LOG_FILE=logs/md2doc.log
MD2DOC_APP_NAME=MD2Doc
MD2DOC_DEFAULT_PANDOC=bin/pandoc.exe
MD2DOC_DEFAULT_TEMPLATE=assets/templates/custom-reference.docx

Execução em desenvolvimento

python app.py

Estrutura de runtime

Ao rodar o projeto em desenvolvimento ou como executável, a estrutura prática esperada é:

MD2Doc/
├─ MD2Doc.exe
├─ .env
├─ config/
│  └─ md2doc_config.json
├─ logs/
│  └─ md2doc.log
├─ output/
├─ bin/
│  └─ pandoc.exe
└─ assets/
   └─ templates/
      └─ custom-reference.docx

Modo portable

Na pasta dist/ existe o arquivo MD2Doc.zip, pronto para uso em modo portable.

Fluxo recomendado:

1. Extraia MD2Doc.zip
2. Entre na pasta extraída
3. Execute MD2Doc.exe
4. Caso necessário, ajuste .env, config/ e assets/templates/

O pandoc.exe já acompanha a estrutura portable.

Como o app resolve caminhos

• Preferências do usuário: config/md2doc_config.json
• Logs: logs/md2doc.log
• Saída padrão: output/
• Pandoc padrão: bin/pandoc.exe
• Template padrão: assets/templates/custom-reference.docx

Todos os caminhos relativos do .env são resolvidos a partir da pasta do projeto ou do executável.

Documentação complementar

A documentação completa do projeto está disponível na pasta docs/.

• 📖 Guia de utilização do aplicativo MD2Doc
• 🧠 Descrição técnica da arquitetura
• 🏗️ Instruções para gerar o executável
• 🐞 Guia para execução em modo desenvolvimento

Autor

Christopher N. S. M. Mauricio