Pandoc Markdown → ABNT/LaTeX: Workflow de Tese 2026 Passo a Passo

Escrever uma tese ou dissertação diretamente em LaTeX pode ser intimidante. Escrever em Word pode ser frustrante — formatação que se desfaz, referências que se perdem, controlo de versões inexistente. Existe uma terceira via que combina a simplicidade do Markdown com a precisão tipográfica do LaTeX e a conformidade automática com as normas ABNT NBR 6023 e NBR 14724:2024: o workflow Pandoc.

Em 2026, com o Pandoc 3.x, os templates ABNTeX-o-matic e abnt-pandoc, e a integração com GitHub Actions para compilação contínua, escrever uma tese em Markdown com saída PDF ABNT-compliant tornou-se uma solução madura — e a preferida por doutorandos de STEM e Ciências Sociais no Brasil que preferem focar no conteúdo, não na formatação.

Por que escrever a tese em Markdown?

O Markdown é um formato de texto simples com marcações mínimas que se converte para qualquer outro formato via Pandoc. As vantagens para doutorandos e mestrandos são concretas:

• Foco no conteúdo: Nenhuma distração de formatação — o template cuida do ABNT/LaTeX
• Controlo de versões: Ficheiros .md são texto puro — funcionam perfeitamente com Git/GitHub
• Múltiplos outputs: Um único ficheiro fonte → PDF (ABNT), .docx (para orientador), .epub, HTML
• Portabilidade: Escreves em qualquer editor (VS Code, Obsidian, Zed, até Notepad)
• Sustentabilidade: Ficheiros .md vão continuar legíveis daqui a 50 anos; não há lock-in de software
• Colaboração: Orientadores podem comentar via Git pull requests ou Track Changes no .docx gerado

A desvantagem principal é a curva de aprendizagem inicial — especialmente para quem nunca usou linha de comandos. Este guia minimiza essa curva com comandos concretos e templates prontos a usar.

Passo 1 — Instalar Pandoc 3.x e TeX Live

Instalar Pandoc 3.x

Vai a pandoc.org/installing.html e segue as instruções para o teu sistema:

• Windows: Descarrega o instalador .msi ou usa winget install JohnMacFarlane.Pandoc
• macOS: brew install pandoc (Homebrew) ou descarrega o .pkg
• Linux (Ubuntu/Debian): sudo apt install pandoc (verifica que é versão ≥ 3.x) ou descarrega o .deb mais recente do GitHub

Verifica a instalação: pandoc --version deve retornar pandoc 3.x.x.

Instalar TeX Live (motor LaTeX)

O Pandoc precisa de uma distribuição LaTeX para gerar PDFs:

• Windows: MiKTeX (miktex.org) com instalação automática de pacotes
• macOS: MacTeX (tug.org/mactex) — instalação completa (~5 GB) ou BasicTeX (~100 MB) com tlmgr para instalar pacotes on demand
• Linux: sudo apt install texlive-full (completo) ou texlive-base + texlive-lang-portuguese + pacotes adicionais via tlmgr

Verifica: pdflatex --version deve funcionar sem erro.

Instalar pacotes LaTeX ABNT necessários

O template ABNTeX requer os seguintes pacotes TeX (instala via MiKTeX Package Manager ou tlmgr):

• abntex2 — template base ABNT
• biblatex-abnt — estilo bibliográfico ABNT para BibLaTeX
• fontenc, inputenc, babel (com opção portuguese)
• microtype, hyperref, bookmark

Passo 2 — Escolher e configurar o template ABNT

Existem duas opções principais de template Pandoc para ABNT em 2026:

Opção A — ABNTeX-o-matic (bcdavasconcelos)

O ABNTeX-o-matic de Bernardo César Diniz Atkinson Vasconcelos é o template mais completo e ativamente mantido para Pandoc + ABNT. Funciona como um template LaTeX pré-configurado onde o Pandoc insere o conteúdo Markdown automaticamente.

1. Descarrega o repositório: git clone https://github.com/bcdavasconcelos/ABNTeX-o-matic
2. Lê o ficheiro README.md — explica a estrutura do YAML header e as opções disponíveis
3. Copia o ficheiro de exemplo dissertacao.md como ponto de partida para a tua tese

Opção B — abnt-pandoc (dsoaress)

O abnt-pandoc de Diego Soares é uma alternativa mais leve, especialmente indicada para dissertações de mestrado mais simples ou para quem prefere uma estrutura de ficheiros mais enxuta.

1. Descarrega: git clone https://github.com/dsoaress/abnt-pandoc
2. Segue o README para configuração básica

Qual escolher?

Para teses de doutoramento com múltiplos capítulos, apêndices, equações e figuras: ABNTeX-o-matic. Para dissertações de mestrado mais compactas: abnt-pandoc. Ambos produzem PDF conformes NBR 14724:2024.

Passo 3 — Estrutura do YAML header da tese

O YAML header é o bloco no início do ficheiro Markdown (entre ---) que define os metadados da tese e as opções de compilação. Exemplo completo:

---
title: "Título Completo da Tese Conforme ABNT"
author: "Nome Completo do Autor"
date: "2026"
institution: "Universidade Federal de São Paulo"
faculty: "Escola Paulista de Medicina"
department: "Programa de Pós-Graduação em Ciências da Saúde"
type: "Tese de Doutorado"
advisor: "Prof. Dr. Nome do Orientador"
co-advisor: "Prof. Dr. Nome do Coorientador"  # opcional
city: "São Paulo"
year: "2026"
abstract: |
  Resumo em português conforme ABNT NBR 14724:2024.
  Máximo 500 palavras.
abstract-en: |
  Abstract in English. Maximum 500 words.
keywords: [palavra-chave 1, palavra-chave 2, palavra-chave 3]
keywords-en: [keyword 1, keyword 2, keyword 3]
bibliography: referencias.bib
csl: abnt.csl  # ou abnt-6023-2018.csl
lang: pt-BR
geometry: "left=3cm, right=2cm, top=3cm, bottom=2cm"
fontsize: 12pt
linestretch: 1.5
toc: true
toc-depth: 3
lof: true  # lista de figuras
lot: true  # lista de tabelas
---

Passo 4 — Escrever em Markdown (sintaxe essencial)

A escrita do conteúdo da tese usa Markdown standard com algumas extensões Pandoc:

Estrutura de capítulos

# 1 INTRODUÇÃO

Texto do capítulo de introdução...

## 1.1 Objetivos

### 1.1.1 Objetivo Geral

### 1.1.2 Objetivos Específicos

# 2 REFERENCIAL TEÓRICO

Formatação básica

**negrito** | _itálico_ | ~~tachado~~

> Citação direta longa (mais de 3 linhas) — recuo automático em LaTeX.

![Legenda da figura](caminho/para/figura.png){#fig:id width=80%}

Ver @fig:id para detalhes.

Tabela: Legenda da tabela {#tbl:id}

| Coluna 1 | Coluna 2 | Coluna 3 |
|----------|----------|----------|
| Dado 1   | Dado 2   | Dado 3   |

Passo 5 — Citações e referências com citeproc + .bib

O sistema de citações usa um ficheiro .bib (exportado do Zotero via Better BibTeX) e um ficheiro .csl (estilo de citação).

Exportar a biblioteca do Zotero em BibTeX

1. No Zotero, seleciona a coleção da tua tese
2. Vai a Ficheiro → Exportar biblioteca → formato Better BibTeX
3. Ativa “Manter atualizado” para que o ficheiro .bib se atualize automaticamente quando adicionas referências
4. Guarda como referencias.bib na pasta do projeto

Sintaxe de citação em Markdown

Segundo @silva2024, o fenômeno apresenta...
(SILVA, 2024, p. 45) → [@silva2024, p. 45]
Múltiplas fontes: [@autor2024; @souza2023, p. 12]
Sem autor no texto: [-@silva2024]

O Pandoc usa o sistema citeproc integrado para processar as citações e gerar automaticamente a lista de referências no final da tese, formatada segundo o CSL escolhido (ABNT NBR 6023, APA 7, etc.).

CSL ABNT para Pandoc

Descarrega o ficheiro associacao-brasileira-de-normas-tecnicas.csl do repositório oficial em github.com/citation-style-language/styles e coloca na pasta do projeto.

Passo 6 — Compilar para PDF + .docx + .epub

Comando básico de compilação PDF

pandoc tese.md 
  --template=abntex-o-matic.latex 
  --bibliography=referencias.bib 
  --csl=abnt.csl 
  --citeproc 
  --pdf-engine=pdflatex 
  -o tese.pdf

Compilar para .docx (para partilhar com orientador)

pandoc tese.md 
  --bibliography=referencias.bib 
  --csl=abnt.csl 
  --citeproc 
  --reference-doc=modelo-orientador.docx 
  -o tese-rascunho.docx

Usar um Makefile para simplificar

Cria um ficheiro Makefile na pasta do projeto para não precisar de memorizar os comandos:

PDF:
	pandoc tese.md --template=template.latex --citeproc 
	--bibliography=referencias.bib --csl=abnt.csl 
	--pdf-engine=pdflatex -o tese.pdf

DOCX:
	pandoc tese.md --citeproc --bibliography=referencias.bib 
	--csl=abnt.csl -o tese.docx

clean:
	rm -f tese.pdf tese.docx

Execução: make PDF ou make DOCX.

Passo 7 — Equações LaTeX e diagramas Mermaid

Equações LaTeX

O Pandoc suporta equações LaTeX inline e em bloco diretamente no Markdown:

Equação inline: $E = mc^2$

Equação em bloco:
$$
sum_{i=1}^{n} x_i = bar{x} cdot n
$$

Com referência:
$$
H = -sum_{i} p_i log p_i
$$ {#eq:entropia}

Diagramas com Mermaid

Para diagramas de fluxo, sequência ou entidade-relacionamento, usa blocos de código mermaid. Com o filtro Pandoc mermaid-filter (instalar via npm install -g mermaid-filter), os diagramas são renderizados como imagens no PDF:

```mermaid
graph TD
    A[Coleta de Dados] --> B[Análise Qualitativa]
    B --> C[Categorização]
    C --> D[Resultados]
```

Adiciona --filter mermaid-filter ao comando Pandoc para ativar a renderização de diagramas.

Passo 8 — Automatizar com GitHub Actions CI

Configurar GitHub Actions para compilar a tese automaticamente a cada commit elimina o problema de “funciona no meu computador”. Cria o ficheiro .github/workflows/tese.yml:

name: Compilar Tese PDF

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Instalar Pandoc e LaTeX
        run: |
          sudo apt-get install -y pandoc texlive-full
      - name: Compilar PDF
        run: make PDF
      - name: Upload PDF
        uses: actions/upload-artifact@v4
        with:
          name: tese-pdf
          path: tese.pdf

A cada push para o repositório, o GitHub Actions compila a tese e guarda o PDF como artefacto descarregável — útil para partilhar versões com o orientador sem enviar ficheiros por email.

Comparação com workflow LaTeX direto

Para comparação detalhada entre LaTeX e outros formatos para teses, consulta o nosso artigo: Como Escrever Tese em LaTeX e Overleaf: Plantillas UMinho, UP, UC e ISCTE 2026.

Integração com Notion/Obsidian (exportação para Markdown)

Se já usas o Obsidian para tomar notas de literatura e redigir capítulos, a migração para o workflow Pandoc é quase direta: os ficheiros Obsidian são Markdown. A principal diferença é o YAML header e a sintaxe de citação:

• No Obsidian, as citações podem vir do plugin Citations (integrado com Zotero) com formato [@citekey] — compatível com Pandoc citeproc
• Adiciona o YAML header ao teu ficheiro Obsidian antes da compilação Pandoc
• As imagens Obsidian (com syntax ![[ficheiro.png]]) precisam de ser convertidas para syntax Markdown standard ![legenda](ficheiro.png)

Para utilizadores de Notion, exporta os capítulos como Markdown via “Exportar → Markdown & CSV” e adiciona o YAML header antes de compilar com Pandoc. Para estudantes italianos que usem o Word com integração de plugins académicos, o artigo sobre como integrar o Tesify com o Word italiano em 2026 via plugin documenta o fluxo equivalente em contexto de teses italianas — útil como referência comparativa para cotutelas PT-IT.

Perguntas frequentes (FAQ)