Voltar aos guias
DeMindsObsidianMarkdownLocal-first

De um Obsidian Vault para um documento de trabalho do DeMinds

Um Obsidian Vault raramente é apenas um arquivo Markdown. Em geral, ele é um espaço de trabalho estruturado, formado por pastas, uma nota inicial, Wiki Links, anexos e convenções de escrita. Quando o DeMinds abre esse tipo de conteúdo, ele não tenta assumir o controle de todo o Vault nem se transformar em outro Obsidian.

Mais precisamente, o que o DeMinds faz é isto: transforma o conteúdo do Vault explicitamente selecionado pelo usuário em um documento de trabalho Markdown legível, editável, visualizável e exportável.

De um Vault para um documento de trabalho do DeMinds

1. Detectar a entrada primeiro, em vez de abrir README às cegas

Um Markdown Package comum costuma usar README.md, index.md ou um arquivo Markdown com o nome do pacote como entrada. Já um Obsidian Vault frequentemente tem uma nota inicial própria, como Home/Home.md, que pode ser referenciada por .obsidian/app.json ou por uma configuração de plugin Homepage.

O DeMinds dá prioridade a esses sinais de página inicial do Obsidian. Assim, quando o usuário abre um Vault, a entrada recomendada fica mais próxima do caminho de leitura original do Vault, em vez de ser dominada por acidente por um README.md na raiz.

O objetivo não é importar automaticamente todo o Vault. O objetivo é ajudar o usuário a começar pelo lugar certo.

2. Deixar o usuário escolher explicitamente o que abrir

Cada arquivo Markdown em um Obsidian Vault pode ter uma função diferente: nota inicial, nota de índice, rascunho, modelo, página de arquivo ou nota diária. O DeMinds não segue recursivamente todos os Wiki Links e não concatena automaticamente todo o Vault em um documento longo.

O usuário escolhe um ou mais documentos Markdown no Document Chooser:

  • Uma seleção única abre esse documento como documento de trabalho
  • Várias seleções geram um novo baseline por ordem ou pela estrutura do Vault
  • Cancelar não cria nenhum espaço de trabalho e não grava nenhum snapshot

Isso mantém clara a fronteira do produto: o DeMinds consegue ler um Vault, mas não indexa todo o Vault; ele cria um documento de trabalho, mas não reescreve no local a pasta original do Obsidian.

3. Preservar a estrutura do Vault em vez de achatar todas as notas

Quando o usuário seleciona vários documentos, o DeMinds pode gerar o documento de trabalho de acordo com a estrutura do Vault. Por exemplo, Areas/Research/Methods/Literature Review.md não deve virar apenas mais um item em uma lista plana. Sua posição dentro do Vault carrega significado.

Estrutura do Vault e Folder Notes

Isso é importante para a leitura. Em muitos Obsidian Vaults, a estrutura de pastas faz parte da organização do conhecimento. Diretórios como Product, Package, Obsidian e Scenarios não são apenas contêineres; eles expressam contexto e limites de conteúdo.

Um documento normalizado pelo DeMinds deve manter essa estrutura visível e, ao mesmo tempo, convergir o conteúdo selecionado para um único documento de trabalho Markdown, que possa ser lido tanto em Mind Map quanto em Markdown Preview.

4. Tratar Wiki Link e Wiki Embed de forma estática

Os elementos do Obsidian [[Wiki Link]] e ![[Wiki Embed]] são centrais para a experiência de leitura dentro de um Vault. No entanto, o DeMinds não executa plugins do Obsidian nem expande todo o grafo de links.

Em vez disso, o DeMinds usa normalização estática:

  • Um Wiki Link que aponta para uma nota selecionada e resolvida de forma única pode se tornar um link interno dentro do documento de trabalho
  • Um Wiki Link não selecionado, ausente ou ambíguo é rebaixado para texto legível
  • Wiki Embeds de imagem são convertidos em referências de imagem Markdown padrão
  • Embeds de notas não são expandidos recursivamente; permanecem como referências legíveis

Assim, o conteúdo continua legível, a estrutura permanece controlada e o resultado exportado continua sendo Markdown comum, em vez de um estado dependente do runtime do Obsidian.

5. Os caminhos dos recursos precisam permanecer autocontidos

Markdown Packages e Obsidian Vaults frequentemente contêm recursos com o mesmo nome de arquivo. Pastas diferentes podem conter um a.png; um documento pode referenciar images/a.png, enquanto outro referencia assets/a.png.

Se os recursos forem mesclados apenas pelo nome do arquivo, as imagens podem facilmente apontar para o arquivo errado. O DeMinds precisa de um fechamento de recursos baseado em caminhos: ele mantém apenas os recursos diretamente referenciados pelos documentos selecionados, que existem de fato e estão dentro de uma fronteira segura.

Caminhos de recursos e exportação

Em um baseline mesclado, as referências a recursos são reescritas para caminhos relativos explicáveis e exportáveis. Assim, o Markdown Package exportado permanece autocontido e pode ser lido e mantido fora do DeMinds.

6. O suporte a Markdown Package é a base

O suporte a Obsidian Vault não é uma capacidade isolada. Ele se apoia nas capacidades de Markdown Package do DeMinds: recomendação de entrada, Document Chooser, mesclagem de vários documentos, fechamento de recursos e exportação preservando caminhos.

Fluxo de abertura de um Markdown Package

Um Markdown Package comum geralmente combina melhor com mesclagem por ordem. Um Obsidian Vault geralmente combina melhor com a estrutura do Vault. Ambos seguem o mesmo princípio de base: gerar um documento de trabalho em torno da seleção explícita do usuário, em vez de copiar todo o pacote.

7. O valor do DeMinds: transformar estrutura em documento de trabalho

O DeMinds não tenta substituir o Obsidian nem recriar dentro do app todos os recursos de uma base de conhecimento. Ele é mais adequado para este fluxo de trabalho:

  1. Pegar de Obsidian, uma página web, uma conversa AI ou um Markdown Package o conteúdo com o qual você quer continuar trabalhando
  2. Normalizá-lo em um documento de trabalho Markdown
  3. Revisar sua estrutura em um Mind Map
  4. Lê-lo em Markdown Preview
  5. Continuar editando, organizando e exportando

Mapa de valor do usuário

Para ativos de conhecimento de longo prazo, o valor é claro: o conteúdo permanece em Markdown, a estrutura pode ser vista como Mind Map, os caminhos de recursos continuam portáveis e o resultado não fica preso a uma única ferramenta.

8. Um cenário típico: organizar conversas AI

Muitas conversas AI são úteis quando criadas, mas, quando guardadas por muito tempo, tendem a virar textos longos difíceis de manter. O DeMinds pode transformar esse tipo de conteúdo em Markdown estruturado e ajudar a levá-lo para um fluxo de conhecimento mais duradouro.

De conversa AI para Markdown estruturado

Esse processo segue a mesma lógica do tratamento de um Obsidian Vault. O DeMinds se importa menos com a ferramenta de origem e mais com a possibilidade de transformar o conteúdo em Markdown estruturado, legível, editável e portátil.

Encerramento

“De um Obsidian Vault para um documento de trabalho do DeMinds” não é uma migração completa nem uma substituição do Obsidian.

É um fluxo de leitura estruturada: o DeMinds detecta a entrada, permite que o usuário escolha o conteúdo, preserva a estrutura do Vault, trata links e anexos de forma estática e gera um documento Markdown no qual é possível continuar trabalhando.

Essa é a posição central do DeMinds: um espaço de trabalho local-first de Markdown + Mind Map que mantém os ativos de conhecimento legíveis, editáveis e portáteis.