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
Os metadados de frontmatter podem ser gerados em 3 formatos, controlados pela configuração metaOutputFormat:
| Formato de saída | Sintaxe | Usado para |
|---|---|---|
| Frontmatter YAML | ---\nkey: value\n--- | Markdown (.md) |
| Metadados inline | **Rótulo:** valor | Notion, TXT/MD |
| Texto simples | Rótulo: valor | TXT |
Cada formato de exportação (Markdown, TXT, PDF, Word, JSON, Notion, Área de transferência) pode ter os metadados ativados ou desativados independentemente através dos toggles de FORMATOS DE SAÍDA na seção Frontmatter.
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.