Configuração
A configuração Notemd abrange 6 áreas principais: (1) provedores LLM e chaves API, (2) seleção do modelo por tarefa, (3) caminhos e modelos de saída, (4) idioma UI e idioma de saída, (5) serviços de busca (Tavily/DuckDuckGo), (6) fluxos de trabalho personalizados. Todas as configurações ficam em Obsidian Settings → Notemd. As alterações entram em vigor imediatamente.
Visão Geral das Configurações
Acesso: Obsidian Settings (⚙️) → Notemd
Seções Principais
- Configuração do Provedor — chaves API, base URLs, modelos
- Configurações da Tarefa — seleção do modelo por tarefa
- Configuração de Saída — onde salvar os arquivos gerados
- Configurações de Idioma — UI e idiomas de saída
- Integração de Busca — configuração Tavily/DuckDuckGo
- Fluxos de Trabalho — cadeias personalizadas de botões
- Avançado — diagnósticos, processamento em lote, chunking
1. Configuração do Provedor
Adicionando um Provedor
- Selecione o provedor na lista suspensa (mais de 30 disponíveis)
- Insira a chave API
- Opcional: Defina uma base personalizada URL (para proxies/gateways)
- Clique em "Obter Lista de Modelos" para verificar a conexão
- Selecione o modelo padrão
Provedores Comuns
OpenAI
Provider: OpenAI
API Key: sk-...
Base URL: https://api.openai.com/v1 (default)
Model: gpt-4o-mini
Anthropic (Claude)
Provider: Anthropic
API Key: sk-ant-...
Model: claude-sonnet-4-6
Ollama (Local)
Provider: Ollama
Base URL: http://localhost:11434 (default)
Model: llama3.1
API Key: (not required)
DeepSeek
Provider: DeepSeek
API Key: sk-...
Model: deepseek-chat
Vários Provedores
É possível configurar vários provedores e alternar entre eles por tarefa:
- Provedor principal: Usado como fallback
- Provedores específicos da tarefa: Substituem para tarefas específicas
2. Modelos Específicos da Tarefa
Configure modelos diferentes para tarefas distintas a fim de otimizar custo/qualidade:
Tipos de Tarefa
| Tarefa | Modelo Padrão | Finalidade |
|---|---|---|
| Vinculação | Provedor Principal | Identificar conceitos para links da wiki |
| Geração de Conceitos | Fornecedor principal | Extrair e descrever conceitos |
| Pesquisa | Fornecedor principal | Resumir resultados de busca na web |
| Tradução | Fornecedor principal | Traduzir texto |
| Geração de Diagramas | Fornecedor principal | Gerar diagramas Mermaid/Canvas |
Exemplo: Configuração otimizada em termos de custo
Linking: gpt-4o-mini (fast, many calls)
Concept Generation: claude-sonnet-4-6 (quality extraction)
Research: gpt-4o (web-grounded)
Translation: gemini-flash (multilingual)
Diagram: ollama/llama3.1 (free, local)
Como configurar
- Configurações → Notemd → Configurações da tarefa
- Para cada tarefa, escolha:
- ✅ Usar o fornecedor principal (padrão)
- 🔄 Usar fornecedor personalizado → selecionar fornecedor + modelo
3. Configuração de saída
Saída das notas dos conceitos
Onde as notas de conceito novas são salvas:
Settings → Output → Concept Folder
Default: concepts/
Modelo:
Settings → Output → Concept Template
Default:
---
tags: [concept]
created: {{date}}
---
# {{concept}}
{{description}}
## Backlinks
{{backlinks}}
Opções de Estrutura de Pastas
Opção 1: Plana (todos os conceitos em uma única pasta)
vault/
└── concepts/
├── Machine Learning.md
├── Neural Networks.md
└── Deep Learning.md
Opção 2: Hierárquica (por pasta de origem)
vault/
├── papers/
│ └── concepts/
│ └── Transformer.md
└── notes/
└── concepts/
└── Attention Mechanism.md
Configurar: Configurações → Saída → Usar Pastas Hierárquicas
Saída do Diagrama
Onde os diagramas são salvos:
Settings → Output → Diagram Folder
Default: diagrams/
Formato:
.mmd(Mermaid origem).canvas(JSON Canvas).html(Vega-Lite)
4. Configurações de Idioma
UI Idioma
Idioma da interface (botões, menus, diálogos):
Settings → Language → UI Language
Options: 21+ languages
Default: System language
Suportados: Inglês, 简体中文, 繁體中文, 日本語, 한국어, Español, Français, Deutsch, Русский, العربية e mais.
Idioma de Saída
Linguagem do conteúdo gerado (notas conceituais, resumos de pesquisa):
Settings → Language → Output Language
Options: Same as UI languages
Default: Same as UI
Caso de uso: Chinês UI + saída em inglês para pesquisas bilíngues.
Alvo de tradução
Linguagem alvo padrão para tarefas de tradução:
Settings → Translation → Target Language
Default: English
5. Integração de busca
Tavily (Recomendado)
Serviço de busca otimizado por IA:
Settings → Search → Service: Tavily
API Key: tvly-...
Obter chave: tavily.com
Recursos:
- Resultados de alta qualidade
- Resumos otimizados por IA
- Citações da fonte
DuckDuckGo (Experimental)
Nenhuma chave API necessária:
Settings → Search → Service: DuckDuckGo
Observação: Qualidade inferior, sem personalização.
6. Configuração do fluxo de trabalho
Criando fluxos de trabalho personalizados
Os fluxos de trabalho conectam várias tarefas em um único botão.
- Configurações → Fluxos de trabalho → Adicionar fluxo de trabalho
- Nome: "Fluxo de Análise de Papel"
- DSL:
process-current-add-links>extract-concepts-current>research-and-summarize>summarize-as-mermaid - Salvar
Um novo botão aparece na barra lateral esquerda.
Sintaxe do DSL
Formato: action1>action2>action3
Ações disponíveis:
process-current-add-links— Adicionar links da wiki à nota atualextract-concepts-current— Gerar notas conceituaisresearch-and-summarize— Pesquisa na web + resumotranslate-current— Traduzir a nota atualsummarize-as-mermaid— Gerar diagrama Mermaidprocess-folder-add-links— Processar pastas em lote
Exemplos de fluxos de trabalho:
Extração Rápida de Conceitos:
process-current-add-links>extract-concepts-current
Pesquisa Profunda:
process-current-add-links>research-and-summarize>extract-concepts-current
Análise Multilíngue:
translate-current>process-current-add-links>extract-concepts-current
7. Configurações Avançadas
Processamento em Lote
Processar vários arquivos em paralelo:
Settings → Advanced → Batch Processing
Concurrency: 3 (default)
Quanto maior, mais rápido, mas mais chamadas API.
Fragmentação Inteligente
Para notas longas, divida em fragmentos:
Settings → Advanced → Smart Chunking
Chunk Size: 2000 words (default)
Overlap: 200 words (default)
Impede erros de limite de token.
Painel de diagnósticos
Visualizar logs detalhados:
Settings → Advanced → Enable Diagnostics
Mostra:
- API solicitações/respostas
- Uso de tokens
- Tempos de processamento
- Erros
Detecção de Conceitos Duplicados
Evite conceitos quase idênticos:
Settings → Advanced → Synonym Suppression
Threshold: 0.8 (default, 0-1)
Quanto maior, mais agressiva é a fusão.
Perfis de Configuração
Configurações de Exportação/Importação
Compartilhe configurações entre dispositivos:
- Configurações → Avançado → Exportar Configuração
- Salva
notemd-config.json - Em novo dispositivo: Importar Configuração
O que está incluído:
- Chaves do provedor API (opcional)
- Seleções de modelo
- Caminhos de saída
- Fluxos de trabalho personalizados
Configurações Recomendadas
Para Estudantes
Provider: OpenAI (gpt-4o-mini)
Concept Folder: concepts/
UI Language: System
Output Language: System
Workflow: "Study Flow" (add-links>extract-concepts)
Para Pesquisadores
Providers:
- Linking: DeepSeek (cheap, many calls)
- Concepts: Claude Sonnet (high quality)
- Research: GPT-4o (web-grounded)
Concept Folder: notes/concepts/
Hierarchical: Yes
Workflow: "Paper Flow" (add-links>extract>research>diagram)
Para usuários preocupados com privacidade
Provider: Ollama (llama3.1)
All tasks: Local model
Search: DuckDuckGo (no API)
Diagnostics: Off
Para trabalho bilíngue
UI Language: Chinese
Output Language: English
Translation Target: Chinese
Provider: Gemini (multilingual)
Solução de problemas de configuração
As configurações não foram salvas
- Verifique as permissões do arquivo em
.obsidian/plugins/notemd/ - Tente: Desativar o plugin → Reativá-lo
Chave API inválida
- Sem espaços extras
- Verifique a data de expiração
- Verifique os créditos no painel do provedor
Os modelos não estão sendo carregados
- Clique em "Obter lista de modelos" para atualizar
- Verifique a conectividade da rede
- Tente outro provedor