Olá, Mundo: como este site funciona

Bem-vindo ao log. Este primeiro post também serve como documentação: tudo o que você está lendo é renderizado a partir de um arquivo .mdx que vive no repositório git do site.

A stack

Por baixo do capô, o site inteiro é propositalmente chato:

Next.js 14 (App Router) — a página de bio, este blog e ~/tools são apenas rotas
MDX — os posts são arquivos Markdown em content/posts/, processados com gray-matter
shiki — highlighting de código com um tema verde-terminal personalizado
Vercel — git push → no ar em ~30 segundos

Sem CMS, sem banco de dados. Publicar um post é:

publish.sh

git add content/posts/new-post.mdx
git commit -m "Post: something worth reading"
git push   # a Vercel cuida do resto

Por que MDX

Markdown puro cobre 95% da escrita, mas MDX significa que um post pode incorporar componentes React de verdade quando isso importa — demos interativas, callouts personalizados, talvez até o pixel pet da página inicial.

example.tsx

export function Greeting({ name }: { name: string }) {
  const hour = new Date().getHours()
  const salute = hour < 7 ? 'zzz...' : `hello, ${name}`
  return <span className="glow">{salute}</span>
}

A regra deste blog: se um diagrama ou demo explica melhor do que a prosa, publique a demo dentro do post.

O que vem a seguir

~/tools vai crescer até virar um conjunto de pequenos utilitários — a primeira é uma skill de revisão de artigos acadêmicos
feed RSS, filtro de tags, talvez busca — quando houver posts suficientes para justificar isso

É isso. exit 0.