🎯 Quartz
Em poucas palavras
Quartz é um gerador de site estático (SSG) construído em TypeScript que converte um vault do Obsidian em um website HTML estático e navegável. Ele preserva a estrutura de links bidirecionais do Obsidian, suporta sintaxe Markdown nativa e permite publicação automática de notas marcadas como públicas, ideal para criar jardins digitais públicos (digital gardens), wikis pessoais ou bases de conhecimento online.
📝 Notas e Desenvolvimento
- Funcionamento Base: Quartz processa arquivos Markdown de um repositório Git (geralmente GitHub), aplica templates customizáveis e gera HTML estático que pode ser hospedado em qualquer servidor web
- Preservação de Links: Mantém os links bidirecionais do Obsidian funcionando no website, criando uma experiência de navegação similar ao vault original
- Sistema de Publicação Seletiva: Funciona com frontmatter YAML para controlar quais notas são publicadas (
publish: true/false), permitindo manter conteúdo privado e público no mesmo vault - Zero Dependências de Servidor: Por ser estático, Quartz não requer backend, banco de dados ou servidor dinâmico, tornando-o rápido e fácil de hospedar
- Tema e Customização: Permite customização do tema, layout e comportamento através de configurações e CSS personalizado
- Integração com GitHub: Sincroniza automaticamente com repositórios GitHub, permitindo CI/CD para publicação automática quando notas são atualizadas
- Busca e Navegação: Oferece funcionalidades de busca full-text e geração automática de índices e mapas de conteúdo
- Curva de Aprendizado: Requer conhecimento básico de terminal, Git e conceitos de SSG, mas oferece documentação e comunidade ativa
🔗 Conexões e Contexto
- Atlas: MdC - Gestão de conhecimento pessoal | MdC - Tecnologia
- Notas Relacionadas:
- Conceitos relacionados:
- Obsidian — a ferramenta de origem do conteúdo
- Blog:
- Como minha estrutura de vault evoluiu (e por quê) — uso prático de Quartz na arquitetura de vault
- Conceitos relacionados: