Publicando um conteúdo

Todo conteúdo do site é um arquivo .mdx versionado no Git. Não há painel de administração: publicar é criar um arquivo e fazer push.

1. Escolha a coleção e o idioma#

Os arquivos vivem em content/{idioma}/{coleção}/:

Os idiomas disponíveis são pt e en.

2. Crie o arquivo#

O nome do arquivo é o slug da URL. content/pt/blog/meu-post.mdx vira /estudos/meu-post.

Use o mesmo nome de arquivo nos dois idiomas. É isso que permite ao seletor de idioma levar o leitor do post em português direto para a versão em inglês. Se a tradução ainda não existir, trocar o idioma leva para o índice da seção — não dá erro.

3. Preencha o frontmatter#

O bloco YAML no topo do arquivo. Os campos obrigatórios são title e date:

---
title: "Título do post"
description: "Uma ou duas frases. Aparece na listagem e nos resultados de busca."
date: "2026-07-26"
tags: ["Next.js", "TypeScript"]
---

A lista completa de campos, incluindo os específicos de cada coleção, está na referência de frontmatter.

4. Escreva#

Markdown normal, com algumas coisas a mais:

• Tabelas, listas de tarefas e riscado funcionam (GitHub Flavored Markdown).
• Blocos de código ganham realce de sintaxe automático nos dois temas — basta informar a linguagem depois das crases.
• Títulos ## e ### entram sozinhos no índice lateral "Nesta página".

Comece o texto direto no ##. O # não é usado: o título da página já vem do frontmatter.

5. Deixe como rascunho (opcional)#

Para escrever sem publicar, adicione:

published: false

O arquivo some das listagens, do RSS e do sitemap, mas continua acessível pela URL direta durante o desenvolvimento.

6. Publique#

git add content/
git commit -m "post: título do post"
git push

A Vercel constrói e publica em cerca de um minuto. Como as páginas são geradas estaticamente no build, conteúdo novo só aparece depois de um deploy — editar um arquivo no GitHub também dispara um.

Rodando localmente antes#

npm run dev

O servidor recarrega a cada arquivo salvo. Antes de fazer push, vale rodar:

npm run build

O build falha se algum arquivo estiver sem title ou sem date — é a rede de segurança que impede um frontmatter quebrado de chegar em produção.