🗺️ O Papel do Frontmatter no Ciclo de Vida do Documento

flowchart TD
    FILE["Arquivo .md com Frontmatter YAML"]
    --> SPLIT{"Parser de Arquivo (Jekyll / Hugo / Astro)"}

    SPLIT --> FRONT["Metadados YAML (--- delimitadores ---\nlayout, title, author, tags, date, permalink)"]
    SPLIT --> BODY["Corpo Markdown (Texto, Listas, Código, Diagramas)"]

    FRONT --> CONTEXT["Objeto Global de Dados (ex: page.title, page.tags)"]
    BODY --> HTML_BODY["HTML Renderizado"]

    CONTEXT & HTML_BODY --> TEMPLATE["Engine de Layout (Liquid / Go Templates / JSX)"]
    TEMPLATE --> SITE["Página Final Publicada com SEO, Breadcrumbs e Metatags ⚡"]

    style FILE fill:#ede7f6,stroke:#512da8,stroke-width:2px
    style SPLIT fill:#fff3e0,stroke:#ff9800,stroke-width:2px
    style FRONT fill:#e1f5fe,stroke:#03a9f4,stroke-width:2px
    style BODY fill:#e8f5e9,stroke:#4caf50,stroke-width:1.5px
    style TEMPLATE fill:#fff9c4,stroke:#fbc02d,stroke-width:2px
    style SITE fill:#00897b,stroke:#004d40,stroke-width:2px,color:#ffffff

📖 Fundamentos e Aplicação

O YAML Frontmatter transforma um arquivo de texto simples em um documento rico em metadados para motores de busca (SEO), geradores de sites estáticos (SSGs) e sistemas de gestão de conteúdo (CMS). Ele é posicionado obrigatoriamente no topo absoluto do arquivo, delimitado por três hífens (---).

Campos Essenciais do Frontmatter:

---
layout: default
title: "Guia de Arquitetura de Microsserviços"
author: "Equipe de Engenharia"
date: 2026-09-01
categories: [arquitetura, backend]
tags: [golang, docker, kubernetes]
published: true
permalink: /docs/arquitetura/microsservicos/
---

Taxonomias: Tags vs Categorias

  • Categorias: Hierárquicas e exclusivas, estruturando a URL e o menu principal (ex.: /docs/backend/).
  • Tags: Transversais e não-hierárquicas, conectando conteúdos de diferentes áreas (ex.: #seguranca, #performance).

🧭 Navegação Rápida

| 📖 Teoria | 📊 Slides | 🧠 Quiz | 💻 Exemplos | 🧩 Exercícios | | :— | :— | :— | :— | :— | | Ler Tópico | Ver Slides | Fazer Quiz | Ver Código | Praticar |

🧭 Navegação do Capítulo: ⬅️ Capítulo Anterior · 📚 Sumário do Módulo · ➡️ Próximo Capítulo