Metadados estruturados — Cada exportação é um ativo de conhecimento
O frontmatter YAML transforma suas exportações em Markdown de arquivos de texto simples em ativos de conhecimento estruturados e consultáveis. Cada arquivo carrega metadados ricos que o tornam pesquisável no Obsidian, Notion e outras ferramentas de PKM.
O que é Frontmatter YAML?
Frontmatter YAML é um bloco de metadados estruturados no topo de um arquivo Markdown, delimitado por marcadores ---:
---
title: "Building a REST API with FastAPI"
tags: [python, fastapi, rest-api, backend]
summary: "Step-by-step guide to creating a RESTful API using FastAPI, including authentication and database integration."
model: claude-3.5-sonnet
platform: claude
date: 2024-01-15
word_count: 3420
---Esses metadados são invisíveis no Markdown renderizado, mas legíveis por ferramentas como o Obsidian Dataview, permitindo consultas poderosas em sua base de conhecimento.
Campos disponíveis
Todos os campos podem ser ativados/desativados individualmente em Configurações → Geral → Frontmatter:
INFORMAÇÕES BÁSICAS:
| Campo | Descrição | Padrão |
|---|---|---|
| Título | Título da conversa gerado automaticamente | ATIVADO |
| ID da conversa | Identificador único para o chat | ATIVADO |
| Plataforma | Nome da plataforma de IA (chatgpt, claude, etc.) | ATIVADO |
| Nome do modelo | Modelo de IA usado (gpt-4, claude-sonnet-4, etc.) | ATIVADO |
| URL de origem | Link de volta para o chat original | ATIVADO |
INFORMAÇÕES DE TEMPO:
| Campo | Descrição | Padrão |
|---|---|---|
| Data de criação | Quando a conversa começou | ATIVADO |
| Data de atualização | Quando a conversa foi atualizada pela última vez | ATIVADO |
| Data de exportação | Quando a exportação foi realizada | ATIVADO |
ESTATÍSTICAS:
| Campo | Descrição | Padrão |
|---|---|---|
| Contagem de mensagens | Número de mensagens na conversa | ATIVADO |
| Contagem de palavras | Contagem total de palavras | ATIVADO |
| Tipos de conteúdo | Tipos de conteúdo (código, imagens, tabelas, citações) | ATIVADO |
APRIMORADO POR IA:
| Campo | Descrição | Padrão |
|---|---|---|
| Tags de IA | Tags de tópico geradas por IA | DESATIVADO |
| Resumo de IA | Resumo da conversa gerado por IA | DESATIVADO |
FORMATO:
| Campo | Descrição | Padrão |
|---|---|---|
| Formato de data | ISO 8601 / Apenas data / Local | ISO 8601 |
| Incorporar propriedades nativas | Escrever nas Propriedades do documento PDF / Propriedades do banco de dados Notion | ATIVADO |
Formato de saída por tipo de exportação
O formato dos metadados é determinado automaticamente pelo destino de exportação — não há seletor manual de formato:
| Formato de Exportação | Sintaxe de Metadados | Notas |
|---|---|---|
| Markdown (.md) | YAML Frontmatter ---\nkey: value\n--- | Padrão da indústria, compatible com Obsidian / Hugo / Jekyll |
| Notion | Em linha **Rótulo:** valor | O Notion não suporta YAML frontmatter |
| Texto simples (.txt) | Texto simples Rótulo: valor | Sem sintaxe especial, texto legível puro |
| PDF / Word | Bloco informativo HTML visual | Renderizado como uma tabela de metadados formatada no cabeçalho do documento |
Você pode usar os interruptores OUTPUT FORMATS nas configurações de Frontmatter para ativar ou desativar metadados para cada formato de exportação (Markdown, TXT, PDF, Word, JSON, Notion, Clipboard) independentemente.
Ativando o Frontmatter YAML
O frontmatter YAML é gerado quando Tags e resumos de IA está ativado:
- Vá em Configurações → Geral → 🔗 Provedor de IA
- Selecione um provedor e insira sua chave de API
- Ative Tags e resumos de IA
- Exporte para Markdown — o frontmatter é incluído automaticamente
Sem Tags de IA ativadas, a exportação ainda inclui metadados básicos (data, plataforma, modelo) em um bloco de frontmatter mínimo.
Frequently Asked Questions
Posso ativar/desativar campos individuais do frontmatter?+
Sim. Cada campo (título, conversation_id, platform, model, datas, contagem de palavras, tags, resumo, etc.) pode ser ativado/desativado individualmente em Configurações → Geral → Frontmatter.
Quais formatos de data estão disponíveis?+
Três formatos: ISO 8601 (2024-01-15T10:00:00Z), Apenas data (2024-01-15) e Local (2024/01/15 10:00).
O frontmatter afeta como o Markdown é renderizado?+
Não. A maioria dos renderizadores Markdown oculta o frontmatter por padrão. São metadados, não conteúdo visível.