O App de Notas para Devs que Resolve o que o Obsidian Não Consegue (SiYuan)

BBetter Stack
컴퓨터/소프트웨어창업/스타트업AI/미래기술

Transcript

00:00:00Esta pode ser a melhor alternativa ao Obsidian e ao Notion que encontrei até agora.
00:00:05A maioria de nós, devs, acha que as notas estão organizadas até precisarmos de algo.
00:00:10As minhas são uma bagunça completa, mas, para mim, estão organizadas.
00:00:14Arquivos Markdown, links quebrados, algumas páginas aleatórias do Notion jogadas lá.
00:00:18Nosso código tem estrutura; minhas notas, não.
00:00:21Este é o SiYuan.
00:00:23Uma ferramenta de conhecimento pessoal de código aberto que permite refatorar pensamentos,
00:00:28como código, com IDs de blocos permanentes, bancos de dados, SQL integrado e o total
00:00:33controle local e auto-hospedado que tanto gostamos.
00:00:34Agora nossas notas funcionam mais como o nosso código.
00:00:36Nos próximos minutos, mostrarei por que ela pode ser a melhor ferramenta de notas
00:00:40para desenvolvedores até o momento.
00:00:42O SiYuan é uma base de conhecimento de código aberto com prioridade local.
00:00:50A maioria das ferramentas vincula arquivos, o SiYuan vincula blocos.
00:00:53Assim, cada parágrafo, lista ou bloco de código ganha seu próprio ID permanente.
00:00:59Dessa forma, quando movemos as coisas, nada se quebra.
00:01:02E isso é fundamental se você escreve docs, rastreia bugs ou organiza arquiteturas.
00:01:06Além disso, você tem bancos de dados, consultas SQL, suporte offline e Docker.
00:01:13Em vez de escolher entre poder e propriedade, aqui temos os dois.
00:01:18Deixe-me mostrar como isso funciona na prática.
00:01:20Se você gosta de ferramentas de código aberto e dicas de codificação, inscreva-se no
00:01:24canal da Better Stack.
00:01:25Temos vídeos novos o tempo todo.
00:01:27Basicamente, baixei o repositório, adicionei este arquivo Docker Compose e iniciei
00:01:31com o comando Docker Compose.
00:01:33Estava tudo funcionando em cerca de um minuto, sem complicações.
00:01:37Agora, com um novo caderno, estou pronto para começar.
00:01:40Posso criar uma nota e adicionar um título.
00:01:43Isso funciona exatamente como o Notion.
00:01:46E agora posso adicionar um bloco de código.
00:01:48Vou colocar um pouco de Python aqui.
00:01:50Vou incorporar este bloco em outro lugar também.
00:01:54E aqui está o momento crucial.
00:01:55Eu movo o bloco original e a referência continua funcionando.
00:01:59Sem links quebrados, nunca.
00:02:01Isso muda a forma como pensamos e trabalhamos.
00:02:04Paramos de nos preocupar onde algo está e focamos em onde é útil.
00:02:09Agora vamos criar um banco de dados de tarefas rápido.
00:02:12Vou adicionar algum tipo de bug.
00:02:14Podemos definir um status e uma prioridade.
00:02:16E como o SQL é integrado, posso consultá-lo diretamente nas minhas notas.
00:02:23Além disso, posso entrar na visualização de grafo para ver as conexões.
00:02:26Essa visualização de grafo é incrível e eu adoro essa funcionalidade.
00:02:30Mas a ideia principal aqui é essa, pessoal.
00:02:31São blocos estáveis, bancos de dados reais e uma estrutura que se mantém com este
00:02:37grafo interativo para ver como tudo está conectado no banco de dados.
00:02:43Realmente muito útil.
00:02:45Então, como isso difere do que já estamos usando?
00:02:47Bem, no Obsidian, tudo é baseado em arquivos.
00:02:50No SiYuan, tudo é baseado em blocos.
00:02:53Isso significa que você não está vinculando uma página.
00:02:55Você vincula ao trecho exato de conhecimento dentro dela.
00:02:58Pode ser uma decisão, um bug ou um snippet.
00:03:00Essa é a diferença.
00:03:01O Obsidian parece uma pasta de notas muito robusta.
00:03:04O SiYuan parece mais um sistema estruturado, com bancos de dados e SQL nativos,
00:03:09sem precisar caçar plugins.
00:03:10Agora, compare isso com o Notion.
00:03:12O Notion dá a estrutura, mas, novamente, está tudo lá na nuvem.
00:03:16O SiYuan dá a mesma estrutura localmente, offline e em código aberto.
00:03:21Eu não estou pagando por nada.
00:03:22Devs usam isso para docs de projetos, snippets, wikis pessoais e bases de conhecimento.
00:03:29É basicamente um segundo cérebro local e aberto, mas estruturado como um
00:03:34documento de design de sistema.
00:03:35Então, Notion.
00:03:36Obsidian.
00:03:37Sendo honesto sobre isso, o que deveríamos ser, é ótimo.
00:03:40Atualiza rápido e a auto-hospedagem leva um ou dois minutos com Docker.
00:03:45Referências de blocos dão estabilidade a notas grandes nesse ecossistema frágil,
00:03:51e bancos de dados trazem estrutura séria sem depender da nuvem.
00:03:54Mas por outro lado, ou melhor, falando das desvantagens agora.
00:03:59A desvantagem é que o SiYuan não armazena tudo em Markdown puro.
00:04:03Ele usa um formato próprio e peculiar, o .sy.
00:04:06Portanto, leve isso em consideração.
00:04:08Você pode exportar em Markdown, mas não é nativo do sistema.
00:04:11O mercado de plugins é bem menor, especialmente em inglês, pois a base é chinesa.
00:04:17Alguns acham a interface datada, mas honestamente, se parece muito com o Notion.
00:04:21E com espaços de trabalho gigantescos, você pode precisar otimizar às vezes.
00:04:25Aqui está a maneira mais simples de decidir se deve usar ou não.
00:04:29Se o seu setup é focado em arquivos Markdown e plugins, o Obsidian faz sentido.
00:04:34Mas se suas notas estão virando documentação e sistemas complexos, o SiYuan
00:04:40começa a parecer muito melhor.
00:04:42Use-o se quiser dados estruturados, links fortes e controle total.
00:04:46Minha opinião sobre tudo isso?
00:04:47Se você busca um novo jeito de organizar notas e não investiu pesado no Notion,
00:04:51então use-o.
00:04:53Mas vamos ser realistas.
00:04:54Se você já usa o Notion há tempos, vai ser um pé no saco mudar agora.
00:04:58Seria um transtorno enorme migrar tudo.
00:05:00Provavelmente vale mais a pena manter o Notion ou Obsidian nesse caso.
00:05:03Mas se o seu sistema atual está falhando, vale a pena tentar este.
00:05:06Isso aqui é ótimo.
00:05:08Muito útil, especialmente com aquele gráfico de base de conhecimento.
00:05:11Se gosta de ferramentas de código e dicas assim, inscreva-se no canal da
00:05:15Better Stack.
00:05:16A gente se vê em outro vídeo.

Key Takeaway

O SiYuan oferece uma infraestrutura de notas local e de código aberto baseada em blocos estáveis e consultas SQL nativas, resolvendo a fragilidade de links e a dependência de nuvem encontradas no Obsidian e Notion.

Highlights

  • O SiYuan utiliza IDs de blocos permanentes para cada parágrafo, lista ou trecho de código, impedindo que links se quebrem ao mover informações.

  • A ferramenta oferece suporte nativo para consultas SQL integradas e bancos de dados estruturados sem a necessidade de plugins externos.

  • A instalação via Docker Compose permite configurar um ambiente de notas auto-hospedado e funcional em cerca de um minuto.

  • Diferente do Obsidian, o SiYuan armazena dados no formato próprio .sy em vez de Markdown puro, embora permita a exportação para Markdown.

  • O sistema prioriza o armazenamento local e offline, eliminando a dependência de nuvem presente em ferramentas como o Notion.

  • O ecossistema de plugins é reduzido e majoritariamente focado na comunidade chinesa, o que limita extensões em outros idiomas.

Timeline

Arquitetura baseada em blocos e estabilidade de dados

  • A estrutura do SiYuan atribui IDs permanentes a cada componente individual de informação.
  • A vinculação ocorre no nível do bloco e não apenas no nível do arquivo.
  • O controle total dos dados é garantido por uma abordagem de código aberto e prioridade local.

Notas comuns de desenvolvedores costumam sofrer com links quebrados e falta de estrutura em arquivos Markdown esparsos. Ao tratar cada parágrafo ou snippet como um bloco único com identidade própria, o sistema permite refatorar o conhecimento de forma similar ao código. Essa organização é ideal para documentação técnica, rastreamento de bugs e arquitetura de sistemas.

Implementação prática e funcionalidades de banco de dados

  • A configuração do sistema é realizada rapidamente através de um arquivo Docker Compose.
  • Os bancos de dados internos permitem definir propriedades como status e prioridade para tarefas.
  • Uma visualização de grafo interativa mapeia as conexões entre diferentes pontos do banco de dados.

O processo de início envolve baixar o repositório e executar o comando de subida do container, tornando o ambiente pronto em sessenta segundos. Dentro da interface, blocos de código Python podem ser incorporados em múltiplas páginas sem perder a sincronia com o original. O uso de SQL integrado permite que o usuário realize consultas complexas diretamente no corpo das notas para filtrar informações específicas.

Comparação com Obsidian e Notion

  • O Obsidian opera como uma pasta de arquivos robusta, enquanto o SiYuan funciona como um sistema estruturado.
  • O SiYuan replica a estrutura organizacional do Notion em um ambiente offline e gratuito.
  • A ferramenta elimina a busca por plugins para funções básicas de banco de dados.

No Obsidian, a unidade fundamental é o arquivo, o que limita a precisão das conexões. O SiYuan preenche essa lacuna permitindo links para trechos exatos de conhecimento, como uma decisão específica ou um snippet de código. Em relação ao Notion, a vantagem reside na soberania dos dados e na execução local, sendo comparado a um documento de design de sistema para uso pessoal.

Limitações técnicas e critérios de decisão

  • O formato de armazenamento .sy substitui o Markdown nativo durante o uso do sistema.
  • A comunidade de desenvolvedores de plugins é predominantemente chinesa.
  • A migração de sistemas estabelecidos como o Notion pode gerar um esforço operacional alto.

Embora a exportação para Markdown seja possível, o funcionamento interno depende do formato proprietário, o que pode ser um ponto de atenção para puristas de arquivos abertos. A interface é funcional, assemelhando-se ao Notion, mas pode exigir otimizações em espaços de trabalho muito extensos. A escolha pela ferramenta deve ser baseada na necessidade de dados estruturados e links indestrutíveis, especialmente para quem ainda não possui um sistema de notas consolidado.

Community Posts

View all posts