Pular para conteúdo

Aula 12: Markdown Acadêmico 🎓

Do Rascunho à Publicação Científica 📚


O que vamos aprender hoje? 🎯

  1. Estrutura de Documentos Longos 🏗️
  2. Citações e Referências 🏷️
  3. Sumários e Navegação 🗺️
  4. Normas Técnicas (ABNT) 📏
  5. Exportação Profissional ⚙️

1. Estrutura de Documentos Longos 🏗️

Um artigo não é um post de blog.

Hierarquia é lei!

  • H1: Título
  • H2: Capítulos
  • H3: Seções

2. Citações e Referências 🏷️

Respeite o autor original.


Uso do Blockquote > 💬

Para citações diretas com mais de 3 linhas.

"A documentação é a alma do software." — Autor Desconhecido

Sintaxe: Comece com >.


Notas de Rodapé Bibliográficas 📝

Essenciais para referências.

Sintaxe: [^1] no texto e [^1]: Detalhes no final.


3. Sumários e Navegação 🗺️

O usuário não pode se perder.

O MkDocs gera o menu lateral automaticamente.

Mas você pode usar [TOC] para sumários no corpo.


4. Normas Técnicas (ABNT) 📏

O Markdown é flexível.

Podemos simular a estrutura da ABNT:

  1. Capa (Metadata)
  2. Resumo
  3. Introdução
  4. Conclusão

Tabelas de Dados Pesquisados 📊

Use tabelas para provar seus pontos.

Metrica Valor A Valor B
Teste 1 10ms 20ms

Visualização (Mermaid) 🧜‍♀️

mermaid graph TD A[Markdown] --> B{Pandoc} B --> C[PDF Profissional] B --> D[Word / DOCX] B --> E[LaTeX]


5. Exportação Profissional ⚙️

Onde a mágica acontece.

Use o Pandoc para transformar seu .md em um artigo PDF formatado.


Praticando no Terminal 🐚

$ echo "> Citação Importante" > artigo.md
$ echo "[^1]: Fonte 2024" >> artigo.md
$ cat artigo.md

Dica de Organização 💡

Mantenha um arquivo referencias.md separado.

E linke-o no final do seu artigo principal.


Exercício Rápido 🧠

Como crio um bloco de citação?

A) [quote] B) > ✅ C) " "


Mini-Projeto 🎨

Crie seu artigo_final.md.

  • Título e Resumo
  • Citação Direta (>)
  • 2 Notas de Rodapé
  • Diagrama Mermaid de Fluxo

Resumo da Aula 📝

  • > para citações impactantes.
  • [^n] para referências bibliográficas.
  • Hierarquia de títulos organiza a mente.
  • Pandoc = Exportação de Elite.

Fim do Terceiro Módulo! 🥉

Batch 3 Concluído com Sucesso! 🚀


Próxima Parada... 🚂

Módulo 4 - Documentação Interativa 🎮

Aula 13 - Apresentações com Reveal.js 🎭


Obrigado! 🙏

"Escrever é pensar no papel."

Ver Aula 13