Esta thread é para ajudar quem está interessado em dar os primeiros passos no Obsidian – o aplicativo que eu uso (grátis - incluindo a sincronização entre desktop e celular) pra organizar minhas anotações e referências.
Estou publicando um pouquinho a cada dia, confira!
Esta é uma série de posts sobre o #Obsidian, um poderoso software de anotações que organiza ideias por meio da criação de notas e sua interconexão por links, tags e mais.
Ela iniciou já com 30 posts pré-escritos, todos curtos, para sair no meu blog e nesta thread aqui.
Fiz uma FAQ antecipando respostas minhas a um conjunto de questões sobre a série, e também a perguntas que surgiram em menções anteriores que fiz a essa ferramenta.
O QUE É O OBSIDIAN — O Obsidian é um app multiplataforma para anotações em texto puro ou em Markdown (tipo a formatação do WhatsApp), em que os arquivos residem no disco do usuário, e podem ter links entre si, formando assim uma base de conhecimento - como se fosse uma Wikipédia pessoal.
É uma cria da pandemia: no início da quarentena, a desenvolvedora Erica Xu percebeu sua insatisfação com os aplicativos de anotações, e iniciou o desenvolvimento. https://trilux.org/2024/02/o-que-e-o-obsidian.html
PARA QUE SERVE O OBSIDIAN — O Obsidian surgiu para preencher uma lacuna de aplicativo para anotações (em texto puro ou formatados com Markdown), mas o seu suporte a links o torna uma solução para armazenar uma variedade de informações estruturadas, como coleções, diários, tarefas, planos de aula, aventuras de RPG, pesquisa acadêmica e muito mais.
OBSIDIAN PARA REFERÊNCIAS E PARA CRIATIVIDADE — Conectar conhecimentos com links criados intuitivamente facilita a geração de novas ideias, promove a criatividade e também ajuda na criação de listas de definições, referências acadêmicas, texto em capítulos (como este que você está lendo) e mais.
ONDE O OBSIDIAN GRAVA AS NOTAS — Os seus arquivos ficam sempre sob seu controle, e em formatos amplamente suportados (txt e Markdown).
A estrutura fundamental do conteúdo é o Cofre (ou Vault), que é uma pasta que você cria no seu disco local (ou em um serviço de sincronização) onde o app armazena suas Notas e outras informações.
SINCRONIZANDO O OBSIDIAN - SEM PAGAR — Embora exista o plano pago do Obsidian Sync, a documentação oficial do aplicativo tem informações abundantes sobre como sincronizar sem pagar, usando recursos que você já tenha, como Dropbox, iCloud, Google Drive, OneDrive e SyncThing, entre outros.
O MANUAL OFICIAL DO OBSIDIAN — Boa documentação é importante para dominar uma ferramenta cheia de recursos, opções e modos de uso – e o manual do Obsidian está em https://help.obsidian.md/Home e corresponde: é completo e organizado, trazendo um guia inicial simples e também uma referência detalhada.
OBSIDIAN NO MASTODON E NO BLOG — O Obsidian atualiza regularmente as novidades do app (e de sua comunidade) em seu perfil no Mastodon, que é @obsidian. Os posts incluem avisos de lançamentos de novas versões, evolução nos recursos e na infraestrutura do app, e muito mais.
DESAFIOS NO OBSIDIAN - DIVIDIR PARA CONQUISTAR — O Obsidian é riquíssimo em recursos, e sugiro explorá-lo aos poucos, a não ser que você já chegue conhecendo parte dos seus fundamentos – por exemplo, se está acostumado a editores similares, ou se já criou em Markdown na Wikipédia ou no Github.
INTERFACE - COMO EU USO O OBSIDIAN — A interface do Obsidian oferece muitos recursos avançados e complexos, mas eu a uso no Desktop em um formato básico: uma nota aberta por vez, com a barra lateral visível e mostrando a lista de pastas e de notas do Cofre atual.
O OBSIDIAN É COMPLEXO, MAS NÃO PRECISA SER COMPLICADO — O Obsidian deixa mais à vontade quem se identifica com as demandas originais da sua criadora - uma programadora que sentia falta de recursos avançados. Ao dar seus primeiros passos, lembre-se do “princípio KISS”, e mantenha tudo simples, até poder alçar voos mais altos na sua configuração.
A BUSCA DO OBSIDIAN — O Obsidian é muito mais do que um bloco de notas: ele cria uma base pessoal de conhecimento. Ao acumular muitas notas (eu tenho literalmente milhares!), a função de busca ganha importância, e é por isso que ela está ali na barra lateral.
A imagem mostra, com setas numeradas: (1) onde ativa a barra lateral; (2) onde mostra a busca; (3) onde abre a ajuda dos riquíssimos operadores de busca, que vão além dos mostrados na tela. https://trilux.org/2024/02/a-busca-do-obsidian.html
RIBBON - A FAIXA DE COMANDOS DO OBSIDIAN — A faixa de comandos fica na lateral das janelas da versão Desktop, e dá acesso a recursos como a Troca Rápida (facilita alternar entre as Notas recentes!), a inserção de modelos, o acesso à Daily Note de hoje, a exibição da paleta de comandos, e mais.
@augustocc não sei se vc vai falar isso nas suas dicas, mas tive que trocar o PC que tava o Obsidian. Aí subi o vault no Google Drive e fiquei tão feliz que ele salva suas configurações todas e não precisei baixar todos os plugins no PC novo nem mexer em tudo pra ficar com a carinha que tinha no velho 💜
@bhayashi isso é muito legal né? E o fato de essas coisas ficarem junto no Cofre tb tem a vantagem de que podemos ter cofres diferentes com configurações distintas! (Mas aumenta a importância do backup)
TROCA RÁPIDA E PALETA DE COMANDOS DO OBSIDIAN — Entre as opções da Faixa de Comandos estão duas que eu uso muito, indicadas pelas setas numeradas na imagem: (1) a Troca Rápida, que alterna a aba atual para editar uma Nota recente; e (2) a Paleta de Comandos, que dá acesso direto a tudo que o Obsidian (incluindo os plugins que você tiver) faz, até mesmo o que não é fácil de localizar nos menus. https://trilux.org/2024/02/troca-rapida-e-paleta-de-comandos-do-obsidian.html
EXPANSÃO DA JANELA DO OBSIDIAN — Eu não uso, mas em muitos contextos faz sentido usar as janelas com múltiplas visões que o Obsidian oferece: por exemplo, você pode abrir lado a lado duas Notas relacionadas entre si, ou a edição e a visualização de uma mesma Nota.
OS MODOS DE EDIÇÃO NO OBSIDIAN — Se você usa os recursos de formatação, considere qual dos dois modos de edição prefere: o Live Preview, que exibe tudo formatado (exceto o trecho próximo ao cursor) enquanto edita, e o Source Mode, que exibe sem formatar.
ANATOMIA DE UMA NOTA NO OBSIDIAN — A Nota é o equivalente a um arquivo de texto, ou a uma página na Wikipédia. Seus elementos fundamentais são o Nome – exibido no alto da janela de edição – e o Corpo de Texto, que corresponde às linhas livremente editáveis.
Nomes (setas laranjas na imagem) são importantes no Obsidian, porque é a partir deles que fazemos links para as Notas. Eles não são o mesmo que títulos (seta rosa) - que você também pode definir à vontade. https://trilux.org/2024/02/anatomia-de-uma-nota-no-obsidian.html
LINKS ENTRE NOTAS NO OBSIDIAN — A grande riqueza do Obsidian é permitir links entre contextos diferentes.
Embora isso possa ser feito de maneira complexa, a forma mais básica é super simples: enquanto escreve em uma nota, coloque entre dois pares de colchetes (ou seja, entre [[ e ]]) o nome de uma outra nota, e você terá criado um link para ela.
E quando você digita [, o editor já apresenta um menu das Notas existentes, para facilitar o link.
ORGANIZANDO O OBSIDIAN COM TAGS — Você pode organizar suas Notas como organizaria qualquer conjunto de arquivos: por projeto, por período, etc. Mas o Obsidian te ajuda a organizar, por meio do suporte automático a hashtags – incluindo suporte a sub-tags, como #esportes/vôlei.
@guisso acho que é amanhã, mas tão de passagem quanto todas as outras menções, pois a proposta é limitar a 500 caracteres :) Mas se você escrever um review detalhado sobre esse recurso no seu blog, eu posso incluir o link na thread!
@augustocc eu ainda não testei, ainda estou usando mais o #Loqseq mas to mt querendo o plugin do excalidraw no #Obsidian facilitatia minha vida eu partiria pra usar apenas um app desse tipo
@guisso@augustocc eu curti mais o #Logseq, talvez influenciado pela licença dele. Entre computadores eu uso um repositório privado de git para sync (o logseq faz commits automaticamente) e no cel eu tou experimentando com SyncThing mas uso menos.
ORGANIZANDO O OBSIDIAN COM MOCS — Uma das formas mais poderosas de organizar suas Notas é a criação de MOCs, ou Mapas de Conteúdo.
Um MOC é uma Nota comum, onde você mantém um índice na forma de uma lista de links para outras Notas (ou outros MOCs!), e que você atualiza flexivelmente (é só ir editando!) e da forma que faça sentido no seu contexto, conforme se expande o seu conteúdo. https://trilux.org/2024/02/organizando-o-obsidian-com-mocs.html
MAIS SOBRE MOCS NO OBSIDIAN — Na criação de um projeto, o MOC pode ajudar na organização das Notas de maneiras que vão além do que a barra lateral oferece: é possível ordenar e agrupar à vontade, comentar, referenciar Notas ainda não criadas, etc.
DICA: CRIE NOVAS NOTAS NO OBSIDIAN DIRETAMENTE DE UM MOC — Se você estruturar suas notas usando um MOC (como vimos na dica de ontem), pode incluir nele também os títulos das notas que ainda não escreveu, mas pretende.
AUTOMATIZANDO JOURNALING E ANOTAÇÕES DIÁRIAS NO OBSIDIAN — Se o seu conteúdo é organizado com uma Nota por dia – por exemplo, para tarefas, diário/journaling ou registro de um projeto –, pode fazer uso do recurso Daily Notes, que automatiza a organização dessas notas.
NÃO DEIXE O MARKDOWN SER UMA BARREIRA PARA O OBSIDIAN — O formato Markdown é familiar para quem já formatou textos na Wikipédia e até no Whatsapp (com variações), mas é desconhecido de muitos.
Não deixe ele te assustar: conte com a ajuda das opções Insert e Format, tanto no menu principal quanto ao clicar com o botão direito em um texto selecionado. Se algo der muito errado, coloque o editor no Source Mode e remova com facilidade todas as marcações. https://trilux.org/2024/02/nao-deixe-o-markdown-ser-uma-barreira-para-o-obsidian.html
COMO O OBSIDIAN FORMATA TEXTO — O Obsidian é rico em recursos de formatação.
Use o formato Markdown, similar às mensagens do WhatsApp: cerque um trecho de texto com _ para itálico, ou com ** (dois asteriscos de cada lado) para negrito. Comece a linha com # para fazer um título, ou com - para um item de lista, etc. (o manual explica, e veremos mais exemplos a seguir!). https://trilux.org/2024/02/como-o-obsidian-formata-texto.html
@hellvolution depende do dialeto. No Markdown propriamente dito, são 2 asteriscos de cada lado (e colocar só um asterisco de cada lado produz itálico). O Obsidian interpreta dessa forma, que é a da definição publicada.
Mas tem bastantante variações pelo mundo, a exemplo do Whatsapp, que usa um asterisco de cada lado pra indicar negrito.
IMAGENS NO OBSIDIAN — Pelo mouse, é só arrastar pra janela. A imagem será inserida no local do cursor, e o arquivo dela será copiado para dentro do Cofre.
Digitando, se o arquivo da imagem está no seu Cofre, basta referenciá-lo usando a seguinte sintaxe, com exclamação e 2 pares de colchetes: ![[nomearq.png]]
E se for da Internet, a sintaxe é similar à de um link Markdown, mas também precedido de exclamação: nome da imagem
LISTAS DE PENDÊNCIAS E TO-DO NO OBSIDIAN — Além das listas comuns do Markdown (linhas que começam com hífen e linhas que começam com um número seguido de um ponto), o Obsidian suporta também listas de pendências, exibidas como uma checkbox em que você pode clicar para marcar o completamento.
CITAÇÕES NO OBSIDIAN — Para incluir uma citação no seu texto, basta iniciar as linhas da citação com o caracter >.
Você pode até mesmo aninhar citações dentro de outras citações, bastando iniciar as linhas do segundo nível com >>. Ou com >>>, se houver um terceiro nível, e assim por diante, como no exemplo. https://trilux.org/2024/03/citacoes-no-obsidian.html
QUADROS EXPLICATIVOS (CALLOUTS) NO OBSIDIAN — Para fazer um quadro no seu texto e destacar uma dica, um alerta ou uma referência, você pode usar os callouts, que têm a mesma sintaxe de uma citação (uma sequência de linhas iniciadas por >) mas incluem na primeira linha um identificador especial, que pode ser [!info], [!check], [!cite], e vários outros tipos.
FORMATAÇÃO AVANÇADA NO OBSIDIAN - TABELAS, DIAGRAMAS E MATEMÁTICA — O suporte a formatação no Obsidian inclui recursos extras que os interessados encontrarão na descrição detalhada do manual, incluindo:
🧾 Tabelas usando sintaxe Markdown (barras verticais e hífens)
➡️ Diagramas de processo, estrutura e linhas do tempo, usando sintaxe Mermaid
O post acima conclui o conteúdo que eu havia mapeado originalmente para esta thread apresentando o Obsidian para os interessados.
Foram pouco mais de 30 posts, e eu curti escrever e compartilhar cada um deles. Espero ter ajudado os interessados neste app, ou nesse tipo de aplicação!
Talvez eu volte ao assunto e reviva esta thread no futuro, quando surgir algum tópico adicional a ser agregado a ela. Até mais!
SEGUNDA TEMPORADA: CONECTANDO CONHECIMENTO NO #OBSIDIAN — Bem-vindo à 2ª temporada da nossa série sobre o Obsidian! A grande riqueza desse app é permitir links entre contextos diferentes, conectando a informação.
Indo além do que já vimos ao tratar da organização do conteúdo, agora iremos explorar melhor a estruturação da sua gestão de conhecimento pessoal.
LINKS DIRETOS PARA UM SUBTÍTULO DE UMA NOTA NO #OBSIDIAN — Já vimos que para linkar outra nota, digitamos [[ e o Obsidian ajuda a selecioná-la. Podemos ir além e criar links diretamente para um subtítulo da outra nota: para isso, usamos um # para separar nome da nota e subtítulo. É fácil: após selecionar a nota, digite # e o Obsidian exibe um menu com os subtítulos dela.
No exemplo da imagem, depois de pronto o link fica assim: [[Marcas de refrigerante#Fanta Uva]]
DICAS SOBRE A SÉRIE OBSIDIAN – O conteúdo desta nova temporada faz uso dos conceitos já abordados nos posts anteriores desta thread – talvez você queira relê-los antes de prosseguir!
A série também tem uma FAQ, e é possível que a resposta a alguma das suas dúvidas esteja nela!
Se você estiver lendo a série pelo Mastodon, experimente clicar nos links para a versão publicada no meu blog, que pode ter conteúdo adicional, links, mais recursos de formatação visual, etc.
LINKS PARA OUTROS TRECHOS DE UMA NOTA NO #OBSIDIAN — Além de links diretos para subtítulos de outras notas, também é possível linkar diretamente para quadros, itens de listas e até mesmo para parágrafos individuais da outra nota.
REBATIZANDO UM LINK INTERNO NO #OBSIDIAN — Quando você insere um link para uma nota, o nome dela aparece linkado no seu texto, no ponto em que você inseriu. Mas e se você quiser que apareça outro texto como referência do link? Entra em cena o caracter | para indicar um nome alternativo para o link.
(E dá para ir além! Se você usa muito esse recurso de rebatizar links, pesquise sobre como definir apelidos ou aliases para as notas (e não para os links dirigidos a elas), usando as propriedades YAML suportadas pelo Obsidian!)
POR QUE PREFERIR NOTAS ATÔMICAS NO #OBSIDIAN — Para aproveitar o Obsidian ao máximo como ferramenta de organização do conhecimento, o ideal é preferir notas atômicas, ou seja, dividir a informação em seus menores componentes.
Para fazer isso, criamos notas pequenas e bem interconectadas, usando os recursos que tornam essas conexões mais visíveis e fáceis de expandir e navegar. E é por isso que esta nova temporada da série sobre o Obsidian tem ênfase nos links e combos!
(...) Indo além nesse conceito, na hora de definir se é melhor manter uma nota maior ou quebrar o conteúdo em mais de uma nota, eu faço uso de uma versão adaptada da Filosofia Unix: o ideal é que cada nota fale de apenas uma coisa, mas a descreva bem, e seja fácil de conectar a outras notas.
A frase original é: “Escreva programas que façam uma coisa e a façam bem. Escreva programas para trabalharem juntos.” (Doug McIlroy 1978, apud Peter H. Salus, em "A Quarter Century of Unix".)
TRANSCLUSÃO NO #OBSIDIAN: EMBUTINDO UMA NOTA EM OUTRA — Se você tem um trecho de texto que pode ser aproveitado em vários locais, pode defini-lo em uma nota separada e embuti-la nas demais, aí quando precisar modificá-lo, a atualização se refletirá em todas.
Para fazer isso, basta digitar 
Add comment