🐙 Cap 03: GitHub Flavored Markdown (GFM): Task Lists, Alerts, Autolinks e Diff Highlighting

Guia Avançado de Markdown & Documentação Viva

🗺️ Mapa Conceitual

flowchart LR
    GFM["GitHub Flavored Markdown (GFM)"]
    GFM --> ALERTS["Alertas Visuais: > [!NOTE], > [!TIP], > [!WARNING], > [!CAUTION]"]
    GFM --> DIFF["Realce de Diffs de Código (```diff + / -)"]
    GFM --> AUTO["Autolinks automáticos (#issue, @menções, commit SHAs)"]
    
    style GFM fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px
    style ALERTS fill:#e8f5e9,stroke:#4caf50,stroke-width:1px
    style DIFF fill:#fff3e0,stroke:#ff9800,stroke-width:1px

🎯 Slide 1: Visão Geral e Notação

• Objetivo Central: Dominar os recursos de github flavored markdown (gfm): task lists, alerts, autolinks e diff highlighting.
• Documentação Eficaz: Riqueza semântica e facilidade de leitura.
• Padrão de Engenharia: Docs-as-Code versionados no mesmo repositório do software.

💡 Slide 2: Práticas e Extensões

• Formatações avançadas com GitHub Flavored Markdown (GFM).
• Diagramação dinâmica sem necessidade de softwares pesados de imagem.
• Integração com Obsidian, Canvas e plugins de produtividade.

🚀 Slide 3: Prática e Publicação

• Compilação estática com Jekyll, Docusaurus ou VitePress.
• Automação de testes de integridade de links no CI/CD.
• Publicação de portais ricos e acessíveis na web.

📋 Resumo da Aula & Próximos Passos

• Revise o código de exemplo deste capítulo.
• Complete os exercícios práticos nos 4 níveis de complexidade.
• Realize o quiz formativo interativo para validar sua compreensão.