Introdução ao Notemd
Notemd é um plugin Obsidian sob licença MIT para criar documentos verificáveis: Markdown ligado, conceitos, resumos, traduções e diagramas. Escolher fornecedor, tarefa e âmbito e rever resultados antes de os integrar no conhecimento.
O que é Notemd
Os 36 perfis ligam tarefas do cofre a APIs cloud, gateways e servidores locais. Cada ação cria ou altera documentos segundo o próprio contrato. Executar separadamente ou encadear pela barra lateral.
As saídas permanecem no cofre, mas serviços cloud recebem o conteúdo enviado. Pesquisa Web usa rede. Armazenamento local e inferência local são decisões diferentes.
Escolher um ponto de entrada
| Objetivo | Guia |
|---|---|
| Instalar e verificar primeira saída | Início rápido |
| Repetir tarefas de notas/pastas | Fluxos, lotes |
| Compilar, testar e ampliar | Desenvolvimento |
| Descobrir o contrato público Agent | Agentes |
Capacidades principais
Links e conceitos
O modelo propõe conceitos e ligações. O processamento cria nota separada por padrão. Conceitos exigem pasta configurada; extração independente cria títulos sem backlinks. Ver links e conceitos.
Pesquisa e contexto local
Tavily ou DuckDuckGo fornecem contexto para resumo acrescentado à nota. Pesquisa local delimitada pode adicionar excertos; o índice é lexical, não semântico por embeddings. Ver pesquisa.
Tradução e texto original
Traduzir documentos/pastas ou extrair passagens segundo uma pergunta e verificar citações na fonte. Seleção de texto não restringe tradução do documento. Ver tradução.
Diagramas e exportação
Selecione vários tipos de diagrama numa execução e vários formatos independentes para cada tipo. Desmarcar um tipo conserva os seus formatos; sem seleção, o conteúdo é analisado automaticamente. Manual de diagramas: Draw.io, Drawnix, Mermaid, CircuitikZ.
Fluxos
One-Click Extract adiciona links, gera conteúdo para notas elegíveis da pasta conceptual/selecionada e repara Mermaid em complete. Pode incluir notas anteriores. Cada ação mantém requisitos. A DSL descreve a sequência.
Começar
- Instalar no cofre correto.
- Configurar modelo acessível e testar nota descartável.
- Escolher pasta conceptual e destinos.
- Rever antes de ampliar lotes.
Não existe duração fixa ou tamanho mínimo que garanta utilidade. Começar com entradas inteiramente verificáveis.
Direção dos diagramas
Entradas suportadas usam especificações tipadas e renderização por destino. DiagramSpec define o contrato, não suporte a toda gramática ou disposição de referência.
Circuitos limitam-se a estruturas circuitikz suportadas. TikZJax é externo; a vista não prova compilação nativa. Relações Drawnix estáticas não garantem setas ligadas após reorganização.
Arquitetura
Cada tarefa segue o fornecedor escolhido, analisa/valida resposta e escreve nota ou artefacto. Pesquisa acrescenta contexto opcional; vistas e exportações mantêm limites do formato.
Desenvolvimento identifica módulos e testes. Agentes descreve exports públicos limitados; o registo interno não é API pública geral.
Comparar ferramentas
Escolher conforme transformação de documentos, conversa, links deterministas, pesquisa ou edição nativa. Ler documentação atual e testar a mesma amostra com versões e funções registadas.
Dados e compatibilidade
Cloud recebe entradas, motores de pesquisa consultas e excertos locais podem integrar prompts. Rever rotas por tarefa. Cancelar interrompe trabalho posterior suportado e conserva concluídos, sem garantir fim de geração ou cobrança remota.
O manifesto declara Obsidian 0.15.0 e permite mobile. Essa versão e dispositivos físicos não estão validados atualmente. Exportação nativa pode exigir desktop. As 34 rotas do site, 21 idiomas UI e capacidades do modelo são superfícies diferentes.
Agradecimentos e referências
Notemd é mantido de forma independente. Referências reconhecem influência e interoperabilidade, não endosso, associação ou inclusão de código não comprovada.
- Referências: cloudy-tech-diagrams-skill, Drawnix, diagrams.net, repo-saga.
- Bases e ferramentas: Mermaid, Vega-Lite, Slidev, CircuitikZ, Tectonic, Docusaurus.
- Cada projeto conserva a sua licença; Notemd usa MIT.
Código aberto e apoio
Código · Issues · Contribuir
Relatar problemas com versões, passos e evidência sem conteúdo privado. Primeira tarefa: início rápido.