Obsidian Bases

Skill Obsidian Bases

Este skill permite que o Claude Code crie e edite Obsidian Bases válidos (arquivos .base), incluindo views, filtros, fórmulas e todas as configurações relacionadas.

Visão Geral

Obsidian Bases são arquivos baseados em YAML que definem views dinâmicas de notas em um vault Obsidian. Um arquivo Base pode conter múltiplas views, filtros globais, fórmulas, configurações de propriedades e resumos personalizados.

Formato de Arquivo

Arquivos Base usam a extensão .base e contêm YAML válido. Também podem ser incorporados em blocos de código Markdown.

Schema Completo

# Filtros globais se aplicam a TODAS as views na base
filters:
  # Pode ser uma string de filtro única
  # OU um objeto de filtro recursivo com and/or/not
  and: []
  or: []
  not: []

# Define propriedades de fórmula que podem ser usadas em todas as views
formulas:
  formula_name: 'expression'

# Configure nomes de exibição e configurações para propriedades
properties:
  property_name:
    displayName: "Display Name"
  formula.formula_name:
    displayName: "Formula Display Name"
  file.ext:
    displayName: "Extension"

# Define fórmulas de resumo personalizadas
summaries:
  custom_summary_name: 'values.mean().round(3)'

# Define uma ou mais views
views:
  - type: table | cards | list | map
    name: "View Name"
    limit: 10                    # Opcional: limita resultados
    groupBy:                     # Opcional: agrupa resultados
      property: property_name
      direction: ASC | DESC
    filters:                     # Filtros específicos da view
      and: []
    order:                       # Propriedades para exibir em ordem
      - file.name
      - property_name
      - formula.formula_name
    summaries:                   # Mapeia propriedades para fórmulas de resumo
      property_name: Average

Sintaxe de Filtros

Filtros reduzem resultados. Podem ser aplicados globalmente ou por view.

Estrutura de Filtros

# Filtro único
filters: 'status == "done"'

# AND - todas as condições devem ser verdadeiras
filters:
  and:
    - 'status == "done"'
    - 'priority > 3'

# OR - qualquer condição pode ser verdadeira
filters:
  or:
    - 'file.hasTag("book")'
    - 'file.hasTag("article")'

# NOT - exclui itens correspondentes
filters:
  not:
    - 'file.hasTag("archived")'

# Filtros aninhados
filters:
  or:
    - file.hasTag("tag")
    - and:
        - file.hasTag("book")
        - file.hasLink("Textbook")
    - not:
        - file.hasTag("book")
        - file.inFolder("Required Reading")

Operadores de Filtro

Propriedades

Três Tipos de Propriedades

1. Propriedades de nota - Do frontmatter: note.author ou apenas author
2. Propriedades de arquivo - Metadados do arquivo: file.name, file.mtime, etc.
3. Propriedades de fórmula - Valores computados: formula.my_formula

Referência de Propriedades de Arquivo

A Palavra-chave this

• Em área de conteúdo principal: refere-se ao arquivo base em si
• Quando incorporado: refere-se ao arquivo que está incorporando
• Na sidebar: refere-se ao arquivo ativo no conteúdo principal

Sintaxe de Fórmulas

Fórmulas computam valores de propriedades. Definidas na seção formulas.

formulas:
  # Aritmética simples
  total: "price * quantity"
  
  # Lógica condicional
  status_icon: 'if(done, "✅", "⏳")'
  
  # Formatação de string
  formatted_price: 'if(price, price.toFixed(2) + " reais")'
  
  # Formatação de data
  created: 'file.ctime.format("YYYY-MM-DD")'
  
  # Expressões complexas
  days_old: '((now() - file.ctime) / 86400000).round(0)'

Referência de Funções

Funções Globais

Funções de Qualquer Tipo

Funções e Campos de Data

Campos: date.year, date.month, date.day, date.hour, date.minute, date.second, date.millisecond

Aritmética de Data

# Unidades de duração: y/year/years, M/month/months, d/day/days, 
#                       w/week/weeks, h/hour/hours, m/minute/minutes, s/second/seconds

# Adiciona/subtrai durações
"date + \"1M\""           # Adiciona 1 mês
"date - \"2h\""           # Subtrai 2 horas
"now() + \"1 day\""       # Amanhã
"today() + \"7d\""        # Uma semana a partir de hoje

# Subtrai datas para diferença em milissegundos
"now() - file.ctime"

# Aritmética de duração complexa
"now() + (duration('1d') * 2)"

Funções de String

Campo: string.length

Funções de Número

Funções de Lista

Campo: list.length

Funções de Arquivo

Funções de Link

Funções de Objeto

Funções de Expressão Regular

Tipos de View

Table View

views:
  - type: table
    name: "My Table"
    order:
      - file.name
      - status
      - due_date
    summaries:
      price: Sum
      count: Average

Cards View

views:
  - type: cards
    name: "Gallery"
    order:
      - file.name
      - cover_image
      - description

List View

views:
  - type: list
    name: "Simple List"
    order:
      - file.name
      - status

Map View

Requer propriedades de latitude/longitude e o plugin Maps.

views:
  - type: map
    name: "Locations"
    # Configurações específicas do mapa para propriedades lat/lng

Fórmulas de Resumo Padrão

Exemplos Completos

Base de Rastreamento de Tarefas

filters:
  and:
    - file.hasTag("task")
    - 'file.ext == "md"'

formulas:
  days_until_due: 'if(due, ((date(due) - today()) / 86400000).round(0), "")'
  is_overdue: 'if(due, date(due) < today() && status != "done", false)'
  priority_label: 'if(priority == 1, "🔴 Alta", if(priority == 2, "🟡 Média", "🟢 Baixa"))'

properties:
  status:
    displayName: Status
  formula.days_until_due:
    displayName: "Dias até Vencimento"
  formula.priority_label:
    displayName: Prioridade

views:
  - type: table
    name: "Tarefas Ativas"
    filters:
      and:
        - 'status != "done"'
    order:
      - file.name
      - status
      - formula.priority_label
      - due
      - formula.days_until_due
    groupBy:
      property: status
      direction: ASC
    summaries:
      formula.days_until_due: Average

  - type: table
    name: "Concluídas"
    filters:
      and:
        - 'status == "done"'
    order:
      - file.name
      - completed_date

Base de Lista de Leitura

filters:
  or:
    - file.hasTag("book")
    - file.hasTag("article")

formulas:
  reading_time: 'if(pages, (pages * 2).toString() + " min", "")'
  status_icon: 'if(status == "reading", "📖", if(status == "done", "✅", "📚"))'
  year_read: 'if(finished_date, date(finished_date).year, "")'

properties:
  author:
    displayName: Autor
  formula.status_icon:
    displayName: ""
  formula.reading_time:
    displayName: "Tempo Est."

views:
  - type: cards
    name: "Biblioteca"
    order:
      - cover
      - file.name
      - author
      - formula.status_icon
    filters:
      not:
        - 'status == "dropped"'

  - type: table
    name: "Lista de Leitura"
    filters:
      and:
        - 'status == "to-read"'
    order:
      - file.name
      - author
      - pages
      - formula.reading_time

Base de Notas de Projeto

filters:
  and:
    - file.inFolder("Projects")
    - 'file.ext == "md"'

formulas:
  last_updated: 'file.mtime.relative()'
  link_count: 'file.links.length'
  
summaries:
  avgLinks: 'values.filter(value.isType("number")).mean().round(1)'

properties:
  formula.last_updated:
    displayName: "Atualizado"
  formula.link_count:
    displayName: "Links"

views:
  - type: table
    name: "Todos os Projetos"
    order:
      - file.name
      - status
      - formula.last_updated
      - formula.link_count
    summaries:
      formula.link_count: avgLinks
    groupBy:
      property: status
      direction: ASC

  - type: list
    name: "Lista Rápida"
    order:
      - file.name
      - status

Índice de Notas Diárias

filters:
  and:
    - file.inFolder("Daily Notes")
    - '/^\d{4}-\d{2}-\d{2}$/.matches(file.basename)'

formulas:
  word_estimate: '(file.size / 5).round(0)'
  day_of_week: 'date(file.basename).format("dddd")'

properties:
  formula.day_of_week:
    displayName: "Dia"
  formula.word_estimate:
    displayName: "~Palavras"

views:
  - type: table
    name: "Notas Recentes"
    limit: 30
    order:
      - file.name
      - formula.day_of_week
      - formula.word_estimate
      - file.mtime

Incorporando Bases

Incorpore em arquivos Markdown:

![[MyBase.base]]

<!-- View específica -->
![[MyBase.base#View Name]]

Regras de Aspas YAML

• Use aspas simples para fórmulas contendo aspas duplas: 'if(done, "Yes", "No")'
• Use aspas duplas para strings simples: "My View Name"
• Escape aspas aninhadas corretamente em expressões complexas

Padrões Comuns

Filtrar por Tag

filters:
  and:
    - file.hasTag("project")

Filtrar por Pasta

filters:
  and:
    - file.inFolder("Notes")

Filtrar por Intervalo de Data

filters:
  and:
    - 'file.mtime > now() - "7d"'

Filtrar por Valor de Propriedade

filters:
  and:
    - 'status == "active"'
    - 'priority >= 3'

Combinar Múltiplas Condições

filters:
  or:
    - and:
        - file.hasTag("important")
        - 'status != "done"'
    - and:
        - 'priority == 1'
        - 'due != ""'

Referências

• Bases Syntax
• Functions
• Views
• Formulas