Dá para escrever um TCC, uma monografia ou qualquer trabalho acadêmico em Markdown e entregar no padrão ABNT, sem passar semanas brigando com margens, sumário e numeração no Word. Este guia mostra o que a ABNT pede, os caminhos que existem para sair do Markdown e chegar ao arquivo formatado, as armadilhas de cada um e, no fim, como o LightNote faz isso dentro do editor.
Por que escrever o trabalho em Markdown?
- Texto puro. O arquivo abre em qualquer editor, hoje e daqui a dez anos, e não corrompe nem fica preso a uma versão do Word.
- Foco no conteúdo. Você escreve
## Metodologiae segue. A fonte, a entrelinha e o recuo ficam para a etapa de gerar o arquivo final, e não competem com a escrita. - Versionamento. Texto puro funciona com o Git: dá para ver o que mudou entre a versão que o orientador leu e a atual, e voltar a qualquer ponto.
- Um texto, vários destinos. O mesmo Markdown vira PDF, Word ou página HTML, cada um com a forma que o destino pede.
O preço: o Markdown não tem como dizer “margem de 3 cm” ou “folha de aprovação”. Essa parte vem de um modelo, de uma norma configurada ou de um programa que converte. Por isso a pergunta útil é como converter, e não só como escrever.
O que a ABNT pede, em linhas gerais?
A estrutura e a aparência do trabalho vêm da NBR 14724; as citações no texto, da NBR 10520; a lista de referências, da NBR 6023; a numeração dos títulos, da NBR 6024. Os números abaixo são os que os guias de normalização das universidades repetem; a NBR 14724 teve edição nova em 2024 e a NBR 10520 em 2023, e cada instituição pode acrescentar regras próprias, então o manual da sua universidade manda.
| Item | O que as fontes consultadas dizem |
|---|---|
| Margens (anverso da folha) | 3 cm em cima e à esquerda; 2 cm embaixo e à direita |
| Fonte | Times New Roman ou Arial, corpo 12; notas de rodapé, citações longas, legendas e numeração das páginas em tamanho menor (10 é o mais comum) |
| Entrelinha | 1,5 no texto; espaço simples em citações longas, notas de rodapé e referências |
| Citação direta longa | Mais de três linhas: bloco recuado (4 cm da margem esquerda é o valor repetido nos manuais), sem aspas, em letra menor |
| Citação no texto | Sistema autor-data, com o sobrenome em maiúsculas entre parênteses (SILVA, 2020), ou sistema numérico |
| Numeração das folhas | A capa não leva número; a folha de rosto conta, mas o número não aparece; a numeração visível começa na parte indicada pela instituição (em geral a introdução) |
Fontes: o resumo da NBR 14724:2024 em doutoranathalia.com.br e os manuais de normalização reunidos em buscas como o guia da biblioteca da UEL. A norma em si é vendida pela ABNT; os manuais de universidade são a referência prática. Alguns materiais tratam o recuo de 4 cm como recomendação, e não obrigação — mais um motivo para conferir com a sua instituição.
Quais são os caminhos do Markdown ao trabalho formatado?
| Caminho | Saída | Dá trabalho em… |
|---|---|---|
Pandoc + --reference-doc + estilo CSL da ABNT | Word (.docx) | capa, folha de rosto e sumário (você monta no Word); instalar e usar a linha de comando |
| Limarka (Pandoc + abnTeX2) | PDF (via LaTeX) | instalar Ruby, Pandoc e uma distribuição LaTeX; o repositório não parece receber atualizações há anos |
| abnTeX2 direto, em LaTeX | aprender LaTeX; não é Markdown | |
| Escrever em Markdown e colar no Word | Word | reaplicar estilos à mão no fim |
| Editor com a norma embutida (LightNote) | PDF, impressão, Word | nada de instalar Pandoc ou LaTeX; só cobre o que a seção abaixo descreve |
Pandoc com modelo .docx e CSL
O Pandoc converte Markdown em Word e processa citações com a opção --citeproc. O estilo das citações e das referências vem de um arquivo CSL (--csl, ou o campo csl do cabeçalho do texto) e a bibliografia de um arquivo .bib (campo bibliography). Para a aparência da página, a opção --reference-doc usa um .docx seu como modelo de estilos; é nele que você põe as margens, a fonte e o espaçamento certos, uma vez só.
pandoc tcc.md --citeproc --reference-doc=modelo-abnt.docx -o tcc.docx
O repositório oficial de estilos CSL (citation-style-language/styles) tem o estilo da ABNT. O arquivo se chama associacao-brasileira-de-normas-tecnicas.csl — não existe um abnt.csl oficial com esse nome — e a descrição dele diz que segue a NBR 10520:2023 para citações e a NBR 6023:2002 para referências. A edição da 6023 que a descrição cita é antiga: confira as referências geradas contra o manual da sua universidade e, se preciso, use a variante da sua instituição, que o Zotero e o repositório também listam.
Limarka e abnTeX2
O abnTeX2 é um conjunto de classes e estilos de LaTeX para documentos técnicos e científicos brasileiros segundo a ABNT; a versão 1.9.7 é de novembro de 2018, e a licença é a LPPL. É o caminho mais fiel visualmente, mas exige LaTeX. O Limarka existe para evitar isso: você escreve em Markdown e ele chama o Pandoc com modelos baseados no abnTeX2, gerando o PDF. A descrição do projeto é “escreva seu trabalho de conclusão de curso com as normas da ABNT em Markdown”. O ponto de atenção é a manutenção: o que a ABNT pede mudou depois de 2018 (NBR 14724 em 2024, NBR 10520 em 2023) e o projeto não parece ter acompanhado, então teste com o seu modelo antes de depender dele.
Word no final
Escrever no Markdown e passar para o Word só no fim funciona, desde que você entenda que a conversão deixa os estilos básicos e que capa, sumário e numeração de páginas serão feitos lá. É o caminho mais lento para quem revisa muito, porque cada nova versão pede refazer parte da formatação.
Onde costuma dar problema?
- Referências. A lista de referências depende de os dados da obra (autor, ano, edição, local) estarem completos no .bib. Estilo CSL formata o que recebe; se faltar a editora, a referência sai incompleta sem aviso.
- Citação sem obra. Uma chave digitada errada (
[@silva2020]quando ésilva2020a) vira texto estranho. Procure no resultado final por chaves que sobraram. - Numeração de figuras e tabelas. O Markdown puro não numera. Com Pandoc, é preciso um filtro como o pandoc-crossref; senão, a numeração fica manual e quebra quando você insere uma figura no meio.
- Numeração de páginas. Capa sem número, folha de rosto contada e sem número, numeração visível a partir de certa folha: isso exige seções diferentes no documento final e raramente sai do Markdown sozinho.
- Sumário e listas. No Word, o sumário e a lista de ilustrações são campos que precisam ser atualizados ao abrir o arquivo; antes disso os números de página aparecem errados.
- Folha de aprovação. A NBR 14724 a exige e nenhum Markdown a escreve; ela vem de modelo ou de um recurso do editor.
Como fazer isso no LightNote?
O LightNote é um editor gratuito para Windows e Linux, sem conta, em que os arquivos ficam no seu computador. O lado acadêmico é opcional e vem desligado: quem não escreve trabalho acadêmico não vê menus que não usa. Para ligar, abra Configurações → Recursos → Acadêmico e marque o que for usar. O resto deste guia segue o que a Ajuda do programa descreve.
- Citações e bibliografia. Escreva
[@chave]no texto (ou[@chave, p. 45], com a página). Ao digitar@, o LightNote sugere as obras que conhece, com autor, ano e título. A bibliografia é um arquivo da sua pasta: qualquer.bib,.risou.csl.jsonserve, e ele viaja com as notas no Git ou num pendrive. Para trazer obras há Ferramentas → Bibliografia → Adicionar obra por DOI e Importar do Zotero. A norma de citação (ABNT, APA 7, Vancouver, Chicago ou ISO 690) se escolhe em Ferramentas → Espaço → Configuração do Espaço → Citações. No modo de leitura a citação vira texto formatado e o token[referências], sozinho numa linha, vira a lista das obras citadas. - Numeração de figuras, tabelas e equações. Ponha um rótulo na imagem (
{#fig:ciclo}) e ela ganha a legenda numerada Figura 1 — Ciclo da água. Tabelas e equações têm rótulos próprios ({#tbl:…}e{#eq:…}), e@fig:ciclono texto vira “Figura 1”. Inserir uma figura no meio renumera tudo. Comsection-numbers: truenas propriedades da nota, os títulos ganham a numeração da NBR 6024 (1, 1.1, 1.1.1), e[lista de figuras]e[lista de tabelas]montam as listas da norma. - A norma da página. Em Ferramentas → Norma do trabalho acadêmico você baixa a norma que usa (a lista traz ABNT NBR 14724, APA 7, Chicago/Turabian e ISO 7144). Escolher uma copia o arquivo para
Modelos/Normas/: dali em diante ele é seu, funciona sem internet e pode ser editado — a regra da sua universidade é uma cópia editada. A norma dá à página a forma que a banca confere (margens, fonte, entrelinha, recuo, títulos, legendas e numeração) no PDF, na impressão, no Word e no Typst; a tela de escrita não muda. - Capa, folha de rosto e folha de aprovação. Preencha os dados nas propriedades da capa do Fichário (instituição, curso, autor, título, orientador, cidade, ano) e escreva
[capa],[folha de rosto]e[folha de aprovação], cada um numa linha. A banca vai numa listabanca:, e a data de aprovação, se você a puser, sai escrita. - A obra inteira. O modelo Trabalho acadêmico (com norma) estrutura a pasta com capa, resumo, sumário, capítulos, referências, apêndice e anexo na ordem. Na exportação da pasta, marque Juntar os capítulos num documento só e escolha PDF ou Typst; o sumário e as listas ganham o número da página e a numeração começa onde a norma manda. Ferramentas → Conferir a norma aponta o que a banca costuma devolver: resumo fora do tamanho, palavras-chave, figura sem fonte, citação sem obra, campo da capa que falta.
Para ver tudo funcionando, o modelo Exemplo de TCC (completo), em Estruturar a pasta, cria um trabalho fictício inteiro, com capa, citações e referências, para você copiar o que servir.
Limites a conhecer. No Word, o sumário e as listas de ilustrações são campos: aceite atualizar os campos ao abrir o arquivo (no LibreOffice e no ONLYOFFICE, clique no sumário e escolha Atualizar). Para compor pelo Typst é preciso a versão 0.13 ou mais nova. E a norma baixada é um ponto de partida: a conferência final contra o manual da sua instituição continua sendo sua.


