Como sincronizar o Obsidian entre PC e celular gratuito com Git e GitHub

Aprenda passo a passo como manter seu cofre do Obsidian sincronizado automaticamente entre vários disposivos.

6 de nov. de 2026
Como sincronizar o Obsidian entre PC e celular gratuito com Git e GitHub
0

Introdução

Se você usa o Obsidian em mais de um dispositivo, já deve ter se perguntado como manter suas notas sincronizadas sem pagar uma assinatura mensal. E caso você ainda não conheça o Obsidian, fique tranquilo: este artigo também foi pensado para você começar do jeito certo.

Aqui, vou mostrar o passo a passo completo para instalar e configurar o Obsidian com sincronização gratuita entre Linux, Windows, macOS e Android usando Git e GitHub.

Já existem bons tutoriais sobre isso na internet — a maioria em inglês, sendo que este guia se baseia em um excelente material (veja na seção de referências). Mesmo assim, resolvi escrever a minha própria versão por três motivos:

  1. Existem várias formas de configurar essa sincronização, e aqui mostro o fluxo exato que eu realmente uso no dia a dia;
  2. Ter esse conteúdo detalhado em português facilita muito a vida de quem está começando;
  3. A melhor forma de fixar um conhecimento é tentando explicá-lo para outra pessoa.

Então, vamos lá!

Revisão rápida de Git (para quem está começando)

TIP

Já conhece Git e Obsidian?

O Git é um sistema de controle de versão distribuído. De forma simples, é um software que rastreia o histórico de alterações em arquivos e pastas ao longo do tempo, permitindo que diferentes dispositivos (ou pessoas) trabalhem nos mesmos arquivos sem perder nada.

O Git, por si só, funciona localmente na sua máquina. Para que os seus arquivos fiquem acessíveis em outros dispositivos pela internet, usamos o Git em conjunto com um provedor remoto na nuvem — o mais famoso deles é o GitHub (mas também existem GitLab, Bitbucket, Gitea, entre outros).

No universo do Git, guardamos nossos arquivos dentro de repositórios. Pense em um repositório como uma "pasta inteligente": diferente de uma pasta comum, ela registra exatamente quem adicionou, editou ou removeu cada arquivo, além de guardar o momento exato de cada mudança.

Para acompanhar este tutorial, você só precisa entender quatro conceitos (comandos) básicos:

ComandoO que faz na prática
git cloneFaz o download (clona) de um repositório que está lá no GitHub para dentro do seu computador.
git pullPuxa as atualizações mais recentes do GitHub para atualizar a pasta do seu dispositivo atual.
git commitSalva um "ponto de restauração" local das suas alterações. Imagine como um checkpoint de videogame.
git pushEnvia os seus checkpoints salvos localmente para o repositório remoto lá no GitHub.

Uma breve introdução ao Obsidian

O Obsidian é tanto um editor Markdown quanto um aplicativo de base de conhecimento. Usado da forma mais básica, você pode editar e visualizar arquivos Markdown. Mas seu verdadeiro poder está em gerenciar uma base de conhecimento densamente interconectada. — Documentação oficial do Obsidian

Gosto muito dessa definição oficial porque ela deixa claro que a ferramenta se adapta à sua necessidade: serve tanto para algo simples, como um bloco de notas ou diário pessoal, quanto para uma base de conhecimento complexa — seja para estudos, projetos pessoais ou documentação empresarial. Inclusive, este próprio artigo está sendo rabiscado no Obsidian antes de ir para o blog.

Em resumo: o Obsidian é uma ferramenta de gestão de conhecimento baseada em arquivos de texto no formato Markdown (.md) interligados entre si. Ele não é open-source, mas é 100% gratuito para uso pessoal. Como o nosso foco aqui é a sincronização em nuvem, recomendo ler a introdução oficial caso queira aprender mais sobre os recursos de edição no dia a dia.

Principais vantagens do Obsidian

  1. Resistente à obsolescência: suas notas são arquivos Markdown comuns (texto puro) salvos no seu próprio disco. Se o Obsidian deixar de existir amanhã, seus arquivos continuam sendo seus e podem ser abertos em qualquer editor de texto.
  2. Ecossistema de plugins: possui uma loja gigantesca de extensões criadas pela comunidade para personalizar tudo.
  3. Visão de grafo: exibe visualmente as conexões entre as suas notas, funcionando como as sinapses de um cérebro.
  4. Busca e indexação rápidas: extremamente eficiente mesmo em projetos com milhares de notas.
  5. Multiplataforma: disponível para Windows, Linux, macOS, Android e iOS.
  6. Modelos (Templates): permite criar estruturas prontas para agilizar a criação de notas recorrentes.
  7. Funciona 100% offline: Você não depende de internet para consultar ou editar suas anotações que já estão locais.
  8. Múltiplos cofres (vaults): cada projeto pode ficar isolado em uma pasta (cofre) independente.

O desafio da sincronização

Diferente de ferramentas como Notion, OneNote ou Evernote — onde suas notas ficam obrigatoriamente nos servidores da empresa —, o Obsidian trabalha primeiro com arquivos locais e deixa você escolher como e onde quer sincronizar.

Você pode usar o serviço oficial pago (Obsidian Sync), serviços de nuvem tradicionais (iCloud, OneDrive, Google Drive) ou o Git + GitHub. Para ajudar você a entender os prós e contras de cada abordagem oficial e alternativa (veja a documentação), montei a tabela comparativa abaixo:

MétodoSistemas suportadosVantagensDesvantagens e limitaçõesCusto e perfil ideal
Obsidian SyncWindows, macOS, Linux, iOS, AndroidSolução oficial, criptografada e a mais simples de usar.Nenhuma limitação de compatibilidade relatada. Vale a pena para quem pode pagar e quiser dar uma força para a Obsidian.Custo: pago (assinatura).
Ideal para: quem busca praticidade imediata com poucas configurações.
iCloudmacOS, iOS, iPadOSConfiguração nativa e transparente no ecossistema Apple.Pode causar duplicação e conflitos de arquivos no Windows.Custo: gratuito (cota básica).
Ideal para: quem utiliza exclusivamente dispositivos da Apple.
OneDriveWindows, macOSOpção nativa e muito popular no ecossistema Microsoft.Limitado no Android e sem suporte nativo no iOS.Custo: gratuito (cota básica).
Ideal para: quem usa o Obsidian apenas em computadores Windows.
Google DriveWindows, macOS, AndroidPopular, acessível e funcional entre desktop e Android.Não suportado nativamente no iOS nem com o Linux.Custo: gratuito (15 GB).
Ideal para: usuários de Windows e Android que preferem uma nuvem tradicional.
Git + Provedor Remoto (ex.: GitHub)Windows, macOS, Linux, iOS, AndroidControle de versão robusto, histórico completo e multiplataforma real.Exige configuração inicial de Git e um app auxiliar no celular.Custo: 100% gratuito.
Ideal para: desenvolvedores ou usuários que querem controle total e histórico de notas.

WARNING

A sincronização via Git não é em tempo real

Diferente do Google Docs, a sincronização com Git funciona por temporizador ou gatilhos (por exemplo, salva e envia alterações a cada 1 minuto). Para o fluxo de anotações pessoais, isso é mais do que suficiente e extremamente seguro.

Qual método escolhi e por quê

No meu dia a dia, alterno entre Ubuntu (Linux), Windows e Android. Por isso, as soluções de nuvem tradicionais (como Google Drive ou OneDrive) sempre esbarravam em alguma limitação no Linux ou no celular. Optar por Git + GitHub resolveu a compatibilidade entre todos esses sistemas de uma só vez, além de me dar todo o poder de histórico e backup do Git gratuitamente.

Para fazer essa engrenagem funcionar perfeitamente, além do Git instalado no computador, utilizaremos duas ferramentas gratuitas:

PlataformaFerramenta UtilizadaPapel da Ferramenta
Computador (Desktop)Plugin obsidian-gitAutomatiza os comandos commit, push e pull por baixo dos panos dentro do Obsidian.
Celular (Mobile)App GitSyncAplicativo dedicado que sincroniza a pasta do cofre no celular com o GitHub de forma estável.

IMPORTANT

Por que não usar o plugin obsidian-git também no celular?

No momento em que escrevo este artigo, o suporte mobile do plugin obsidian-git é considerado experimental e instável. Nos meus testes práticos, o aplicativo do Obsidian no celular fechava sozinho (crash) assim que o plugin tentava rodar. Isso acontece porque, no mobile, o plugin não tem acesso ao Git nativo do sistema e precisa usar uma recriação em JavaScript (isomorphic-git), que tem limitações severas de memória e estabilidade. Usar o app GitSync no celular contorna esse problema por completo!

Parte 1: Configuração no Computador (Desktop)

Nesta primeira etapa, vamos preparar o terreno no computador: instalar o Git, criar nosso repositório privado no GitHub, configurar a autenticação segura via chave SSH e, por fim, deixar o Obsidian sincronizando sozinho.

1. Instalando e Configurando O Git

Se você ainda não tem o Git instalado na sua máquina, a instalação é bem rápida:

Com o Git instalado, abra o seu terminal (no Windows, procure pelo programa Git Bash que foi instalado junto com o Git) e configure a sua identidade. Esses dados funcionam como a sua "assinatura" em cada modificação salva:

git config --global user.name "Seu Nome"
git config --global user.email "seuemail@exemplo.com"

TIP

Utilize o mesmo endereço de e-mail da sua conta do GitHub. Assim, o GitHub vincula automaticamente os salvamentos (commits) ao seu perfil.

2. Criando o repositório do cofre no GitHub

Agora vamos criar a "gaveta" na nuvem onde suas notas ficarão guardadas:

  1. Acesse o GitHub e faça login (ou crie uma conta gratuita, caso ainda não tenha).
  2. Crie um novo repositório acessando diretamente github.com/new (ou clicando no ícone de + no canto superior direito da tela e selecionando New repository).
Menu superior do GitHub destacando o botão New repository para criar um novo repositório
  1. Preencha as informações do repositório:
    • Repository name: escolha um nome para o seu cofre (ex.: meu-diario-digital ou obsidian-vault).
    • Description (opcional): coloque uma breve descrição.
    • Visibilidade: certifique-se de marcar a opção Private (Privado), garantindo que apenas você tenha acesso às suas anotações pessoais.
  2. Deixe as demais opções desmarcadas e clique no botão verde Create repository.
Formulário de criação de repositório no GitHub com o nome meu-diario-digital e visibilidade marcada como Private

Ao finalizar, o GitHub exibirá uma página com instruções de conexão. Deixe essa aba aberta, pois usaremos o link do repositório logo mais.

3. Autenticando no GitHub via chave SSH

Para que o Obsidian consiga enviar e baixar suas notas automaticamente sem que você precise digitar usuário e senha toda vez, vamos autorizar o seu computador a acessar o GitHub usando o protocolo SSH.

De forma simples, o SSH funciona com um par de chaves criptográficas:

  • Chave privada: fica guardada em segredo apenas no seu computador.
  • Chave pública: funciona como um cadeado que você entrega ao GitHub para ele reconhecer que o seu computador tem permissão de acesso.

Passo 3.1: Gerando o par de chaves no computador

WARNING

Atenção usuários de Windows

Execute todos os comandos abaixo dentro do Git Bash (e não no Prompt de Comando ou PowerShell padrão), pois o Git Bash já traz todas as ferramentas SSH do Linux prontas para uso.

  1. No terminal (ou Git Bash), execute o comando abaixo trocando pelo seu e-mail do GitHub:
ssh-keygen -t ed25519 -C "seuemail@exemplo.com"
  1. O terminal fará algumas perguntas (onde salvar o arquivo e se deseja definir uma senha/passphrase). Basta pressionar Enter em todas elas para aceitar os valores padrão e deixar sem senha (para que a sincronização automática funcione sem interrupções).

  2. Em seguida, inicie o agente SSH em segundo plano e adicione a sua nova chave privada a ele:

# Inicia o ssh-agent no terminal
eval "$(ssh-agent -s)"
 
# Adiciona a sua chave privada ao agente
ssh-add ~/.ssh/id_ed25519
  1. Agora, vamos criar/atualizar o arquivo de configuração do SSH (~/.ssh/config) para garantir que o sistema sempre use essa chave ao se comunicar com o GitHub. Rode o comando correspondente ao seu sistema operacional:
  • No Linux ou Windows (via Git Bash):
echo -e "Host github.com\n  HostName github.com\n  User git\n  IdentityFile ~/.ssh/id_ed25519\n  AddKeysToAgent yes" >> ~/.ssh/config
  • No macOS:
echo -e "Host github.com\n  HostName github.com\n  User git\n  IdentityFile ~/.ssh/id_ed25519\n  AddKeysToAgent yes\n  UseKeychain yes" >> ~/.ssh/config
  1. Por fim, ajuste a permissão de segurança do arquivo de configuração:
chmod 600 ~/.ssh/config

Passo 3.2: Adicionando A Chave Pública Ao GitHub

Agora precisamos copiar o conteúdo da chave pública (id_ed25519.pub) e cadastrá-la no GitHub.

  1. Copie a chave pública para a sua área de transferência com o comando do seu sistema:
  • Windows (Git Bash):
clip < ~/.ssh/id_ed25519.pub
  • macOS:
pbcopy < ~/.ssh/id_ed25519.pub
  • Linux: (caso não tenha o xclip, você pode exibir a chave na tela com cat ~/.ssh/id_ed25519.pub e selecioná-la para copiar)
xclip -sel clip < ~/.ssh/id_ed25519.pub
  1. Acesse a página de configurações de chaves do GitHub em github.com/settings/keys e clique no botão New SSH key.
Página de configurações de chaves SSH e GPG no GitHub destacando o botão verde New SSH key
  1. Preencha os dois campos:
    • Title: dê um nome que identifique este computador (ex.: Meu Notebook Windows ou PC Linux Casa).
    • Key: cole a chave pública que você copiou no passo anterior.
Formulário de adição de nova chave SSH no GitHub com os campos Title e Key preenchidos
  1. Clique em Add SSH key. Sua chave aparecerá cadastrada na lista:
Chave SSH recém-adicionada listada nas configurações da conta do GitHub
  1. Para confirmar que deu tudo certo, volte ao terminal e faça um teste rápido de conexão com o GitHub:
ssh -T git@github.com

TIP

Se for a primeira vez, o terminal pode perguntar Are you sure you want to continue connecting (yes/no)?. Digite yes e pressione Enter.

Se tudo estiver correto, você receberá uma mensagem de boas-vindas com o seu nome de usuário:

Hi seu-usuario! You've successfully authenticated, but GitHub does not provide shell access.

4. Clonando o repositório para o computador

Com a conexão SSH funcionando, vamos baixar a pasta do repositório que criamos lá no passo 2:

  1. Volte para a página do seu repositório recém-criado no GitHub.
  2. Certifique-se de selecionar a aba SSH (e não HTTPS) e clique no ícone para copiar o endereço git@github.com:...:
Página inicial do repositório vazio no GitHub com a opção SSH selecionada para copiar a URL de clone
  1. No seu terminal (ou Git Bash), navegue até a pasta do computador onde deseja guardar suas notas (por exemplo, a pasta Documentos) e rode o comando git clone colando o link copiado:
cd ~/Documents
git clone git@github.com:seu-usuario/nome-do-seu-repositorio.git

O Git avisará que você parece ter clonado um repositório vazio ("warning: You appear to have cloned an empty repository"), isso é normal. A pasta já foi criada no seu computador e está pronta para ser aberta no Obsidian.

5. Instalando o Obsidian e preparando as pastas de configuração

  1. Baixe e instale o Obsidian através do site oficial para o seu sistema operacional (a instalação segue o padrão de avançar sem segredos). Aproveite também para já deixar o app do Obsidian instalado no seu celular pela Play Store ou App Store.
  2. Ao abrir o Obsidian no computador pela primeira vez, você verá a tela inicial de seleção de cofres.
  3. Em "Abrir pasta como um cofre" (Open folder as vault), clique no botão Abrir e selecione a pasta do repositório que você acabou de clonar na seção anterior:
Tela inicial do Obsidian no computador destacando a opção Abrir pasta como um cofre
  1. O seu cofre abrirá vazio. Clique no ícone de Nova nota (no canto superior esquerdo) e crie uma primeira nota de teste (por exemplo, 2026-11-03-diario com o texto "Hoje eu configurei o Obsidian!"):
Primeira nota criada no Obsidian Desktop com o título 2026-11-03-diario

O segredo para usar no celular

Se você abrir o gerenciador de arquivos do seu sistema operacional e entrar na pasta do seu cofre (habilitando a visualização de arquivos ocultos), notará três itens:

  • .git: pasta oculta do próprio Git, responsável por guardar todo o histórico de versões.
  • .obsidian: pasta oculta onde o Obsidian salva todas as configurações do seu cofre, temas e plugins instalados.
  • O arquivo Markdown (.md) da nota que você acabou de criar.
Explorador de arquivos mostrando as pastas ocultas .git e .obsidian junto ao arquivo da nota

Agora faça o seguinte passo fundamental:

  1. No seu gerenciador de arquivos, selecione a pasta .obsidian, e duplique ela.
  2. Renomeie essa cópia para .obsidian-mobile.
  3. Para evitar que o Git gere conflitos desnecessários apenas porque você deixou uma nota diferente aberta em cada aparelho, crie um arquivo chamado .gitignore na raiz da pasta do seu cofre e adicione as seguintes linhas:
# Arquivos de sessão e estado da janela do Obsidian (Desktop e Mobile)
.obsidian/workspace
.obsidian/workspace.json
.obsidian/workspace-mobile.json
.obsidian/graph.json
.obsidian-mobile/workspace
.obsidian-mobile/workspace.json
.obsidian-mobile/workspace-mobile.json
.obsidian-mobile/graph.json
 
# Arquivos temporários de sistema operacional (macOS e Windows)
.DS_Store
Thumbs.db
 
# Lixeira local e cache de plugins
.trash/

Com isso, o Git vai focar em sincronizar o que realmente importa (suas notas, seus plugins e suas configurações gerais), ignorando qual aba estava aberta em cada tela e arquivos temporários do sistema.

Sua estrutura deve ficar assim:

Explorador de arquivos exibindo as pastas .git, .obsidian, .obsidian-mobile e o arquivo .gitignore

IMPORTANT

Por que precisamos de duas pastas de configuração (.obsidian e .obsidian-mobile)?

Lembra que comentamos antes que o plugin obsidian-git trava no celular? Como o Obsidian guarda a lista de plugins ativos dentro da pasta .obsidian, se o computador e o celular usassem a mesma pasta, o plugin obsidian-git seria carregado automaticamente no celular e faria o aplicativo fechar sozinho!

Criando a pasta .obsidian-mobile, nós podemos configurar o aplicativo do celular para ler as configurações a partir da .obsidian-mobile (onde o obsidian-git não estará instalado), enquanto o computador continua usando a .obsidian padrão. Dessa forma, você ainda pode instalar e usar outros plugins da comunidade normalmente no celular, mantendo as configurações de desktop e mobile totalmente independentes e seguras!

6. Instalando e configurando o plugin obsidian-git

Agora vamos automatizar a sincronização no computador para que você não precise abrir o terminal para salvar suas notas.

Passo 6.1: Instalando e ativando o plugin

  1. No Obsidian do computador, abra as Configurações clicando no ícone de engrenagem no canto inferior esquerdo (ou usando o atalho Ctrl + ,).
  2. No menu lateral esquerdo, clique em Plugins não oficiais (Community plugins).
  3. Caso o "Modo restrito" (Restricted mode) esteja ativo, clique no botão para Desativar e liberar o uso de plugins da comunidade.
  4. Em "Plugins da comunidade", clique no botão Procurar (Browse), pesquise por Git (criado por Vinzent) — ou acesse diretamente pelo link obsidian-git — e clique em Instalar.
  5. Após instalar, volte para a tela de Plugins não oficiais, localize o plugin Git na lista de "Plugins instalados" e ative a chave ao lado dele:
Tela de configurações de Plugins não oficiais do Obsidian com o plugin Git ativado
  1. Clique diretamente em Git no final da barra lateral esquerda das Configurações.

Passo 6.2: Configurando a sincronização automática

Dentro das configurações do plugin Git, role até a seção Automatic. É aqui que definimos a frequência com que o Obsidian vai salvar e buscar atualizações no GitHub. Configure os campos da seguinte maneira:

Campo na interface do plugin (Automatic)Valor para configurarO que essa configuração faz
Auto commit-and-sync interval (minutes)1A cada 1 minuto, se houver alterações nas suas notas, o plugin cria um commit, baixa novidades e envia tudo para o GitHub automaticamente.
Auto pull interval (minutes)2A cada 2 minutos, o plugin verifica se existem alterações novas vindas de outros dispositivos no GitHub e atualiza seu cofre local.
Commit message on auto commit-and-sync(Veja o modelo abaixo)Define o padrão da mensagem automática que ficará registrada no histórico do Git.

Para o campo Commit message on auto commit-and-sync, copie e cole o seguinte modelo informativo (ele registra automaticamente a data/hora, o nome do dispositivo e quais arquivos foram alterados):

[Auto-Backup] {{date}} | Dispositivo: {{hostname}} | Arquivos afetados ({{numFiles}}): {{files}}

Passo 6.3: Configurando os salvamentos manuais e identificação do dispositivo

Continue rolando a página de configurações do plugin até a seção Commit. Aqui vamos padronizar a mensagem de quando você quiser forçar um salvamento manual e dar um nome amigável para identificar o seu computador no histórico do Git:

Campo na interface do plugin (Commit)Valor para configurarO que essa configuração faz
Stage all changes when nothing is stagedAtivado (padrão)Garante que todos os arquivos modificados sejam incluídos ao fazer um commit manual.
Commit message on manual commit(Veja o modelo abaixo)Define a mensagem padrão quando você acionar um backup manual pela interface gráfica.
{{date}} placeholder formatYYYY-MM-DD HH:mm:ssFormato de data e hora utilizado na variável {{date}}.
{{hostname}} placeholder replacementEx.: Desktop Windows (ou Notebook Linux)Substitui a variável {{hostname}} pelo nome do dispositivo, facilitando saber de qual máquina veio cada alteração.

No campo Commit message on manual commit, copie e cole o seguinte modelo:

[Manual-Backup] {{date}} | Dispositivo: {{hostname}} | Arquivos afetados ({{numFiles}}): {{files}}
Seção Commit nas configurações do plugin Obsidian Git mostrando a mensagem de backup manual e identificação do dispositivo

Passo 6.4: Verificando o resultado no GitHub

Pronto! A partir deste momento, o plugin já está trabalhando em segundo plano. A cada minuto, qualquer alteração feita no seu cofre será empacotada e enviada para o seu repositório privado.

Se você atualizar a página do seu repositório lá no navegador do GitHub, verá que as suas pastas (.obsidian, .obsidian-mobile) e a sua primeira nota já foram sincronizadas com as mensagens personalizadas que configuramos:

Repositório no GitHub atualizado com as pastas .obsidian, .obsidian-mobile e a nota sincronizada via Auto-Backup

WARNING

Solução de problemas: erro de upstream branch no primeiro envio

Como criamos um repositório totalmente vazio no GitHub, pode acontecer de, na primeira tentativa de envio, o plugin exibir um aviso no canto da tela informando que a branch remota (upstream) ainda não foi definida.

Caso isso aconteça e seus arquivos não apareçam no GitHub após alguns minutos, basta abrir o terminal (ou Git Bash) dentro da pasta do seu cofre e rodar os comandos abaixo uma única vez para vincular e enviar a branch principal (main):

# Caso o repositório remoto ainda não esteja vinculado ao origin:
git remote add origin git@github.com:seu-usuario/nome-do-seu-repositorio.git
 
# Envia os primeiros commits definindo a branch remota padrão (upstream):
git branch -M main
git push -u origin main

Depois desse primeiro push, o plugin obsidian-git assumirá o controle e fará todas as próximas sincronizações sozinho!

Parte 2: configuração no celular (Android E iOS) com GitSync

Para sincronizar nosso cofre no celular sem sofrer com travamentos, vamos utilizar o aplicativo GitSync.

Vale deixar aqui os créditos ao desenvolvedor ViscousPotential, que além de criar o aplicativo GitSync, também escreveu o tutorial em inglês que serviu de base para eu adaptar conforme algumas necessidades.

NOTE

O GitSync é gratuito?

Sim! Durante a configuração inicial, você verá uma tela oferecendo uma versão Premium (pagamento único). Porém, ela só é necessária para recursos avançados — como sincronizar múltiplos cofres/repositórios ao mesmo tempo. Para sincronizar o seu cofre principal do Obsidian, a versão gratuita atende 100% do que precisamos.

Abaixo, dividi o passo a passo focando na configuração completa no Android (onde fiz todos os testes práticos com capturas de tela) e destacando também as particularidades para quem usa iOS (iPhone/iPad).

1. Instalando e preparando o GitSync

  1. Baixe e instale o GitSync na loja do seu aparelho (Google Play Store no Android ou App Store no iOS). Certifique-se também de já ter instalado o aplicativo do Obsidian.
  2. (Apenas para usuários de iOS): Por conta do isolamento de pastas da Apple, antes de abrir o GitSync no iPhone/iPad, abra o app do Obsidian, toque em Criar um novo cofre (Create new vault), pule a configuração do Obsidian Sync, dê um nome ao cofre (ex.: meu-diario-digital) e crie-o vazio. Isso criará a pasta oficial do Obsidian dentro do app Arquivos (No Meu iPhone > Obsidian), onde o GitSync poderá colocar os arquivos depois. No Android, você não precisa fazer isso antes.
  3. Abra o GitSync e avance pelas telas de boas-vindas:
    • Na tela "Choose Your Focus" (Escolha seu foco), selecione Sync Mode (recomendado para iniciantes que querem apenas sincronizar em segundo plano) ou Client Mode (se você já conhece Git e quer ver o painel completo de commits e branches na tela inicial).
    • Na tela do plano Premium, basta tocar em Skip (Pular).
    • Conceda as permissões solicitadas: aceite a permissão de Notificações (importante para o app avisar quando estiver sincronizando suas notas) e a permissão de Acesso a todos os arquivos (para que o GitSync possa ler e atualizar a pasta do Obsidian).

2. Autenticando com sua conta do GitHub

No computador nós utilizamos chaves SSH, e você também poderia importar sua chave privada aqui se quisesse. Porém, no celular o GitSync oferece uma opção muito mais rápida e prática: a autenticação direta via OAuth .

  1. Na tela Autenticar do GitSync, em Provedores OAuth, escolha uma das opções do GitHub:
    • GITHUB (SCOPED): mais seguro, pois permite autorizar o acesso apenas ao repositório do seu cofre do Obsidian.
    • GITHUB (ALL REPOS): concede acesso a todos os seus repositórios do GitHub.
Tela de autenticação do aplicativo GitSync no celular mostrando as opções de login via OAuth com GitHub
  1. O navegador será aberto na página oficial do GitHub. Faça o login, selecione o repositório do seu cofre (caso tenha escolhido Scoped) e autorize o aplicativo.
  2. Ao retornar automaticamente para o GitSync, preencha o seu Nome de Autor e seu E-mail para identificar os salvamentos feitos pelo celular no histórico do Git.

3. Clonando o repositório do cofre no celular

Assim que autenticar, o GitSync exibirá a tela Clonar Repositório Remoto listando os seus repositórios do GitHub:

  1. Localize o repositório do seu cofre na lista (no meu caso, meu-diario-digital) e toque no botão verde de download ao lado dele:
Lista de repositórios remotos no GitSync destacando o repositório meu-diario-digital para clonar
  1. O aplicativo perguntará como você deseja clonar a pasta (Clonagem Direta vs. Clonagem Aninhada):
    • No Android: escolha Clone Aninhado (Nested Clone), toque em Selecionar e escolha uma pasta de sua preferência no celular (no meu caso utilizo uma pasta Documents ou obsidian). O GitSync criará automaticamente a subpasta meu-diario-digital lá dentro com todas as suas notas.
    • No iOS: escolha Clone Direto (Direct Clone), navegue até No Meu iPhone > Obsidian, selecione a pasta vazia do cofre que você criou no passo 1 e confirme para Sobrescrever (Overwrite).
 Caixa de diálogo do GitSync perguntando se deseja realizar Clone Direto ou Clone Aninhado

4. Configurando a sincronização automática ao abrir e fechar o Obsidian

Depois de clonar o repositório, o GitSync mostrará o assistente de Config. de Sync para automatizar o envio e recebimento das notas.

No Android, o GitSync utiliza o recurso de acessibilidade do sistema para detectar exatamente quando você abre ou fecha o aplicativo do Obsidian:

  1. No card Config. de Sync do App, siga as instruções na tela para habilitar o serviço do GitSync nas configurações de Acessibilidade do Android.
  2. Ative as duas chaves:
    • Sincronizar ao abrir app(s): sempre que você abrir o Obsidian, o GitSync fará um git pull automático para baixar as notas mais recentes que você escreveu em outro dispositivo.
    • Sincronizar ao fechar app(s): assim que você sair do Obsidian ou bloquear a tela, o GitSync fará um git commit e git push automático para enviar suas edições para o GitHub.
  3. Toque em Selecionar aplicativos, marque o Obsidian na lista e toque em Concluído:
Configuração de Sync do App no GitSync com as opções de sincronizar ao abrir e fechar o aplicativo Obsidian ativadas

TIP

Dica para o Android não pausar o GitSync em segundo plano

Aparelhos de marcas como Samsung, Xiaomi e Motorola costumam suspender serviços de acessibilidade após alguns dias para economizar energia. Para garantir que a sincronização nunca falhe ao abrir o Obsidian, vá nas configurações do Android em Aplicativos > GitSync > Bateria e selecione a opção Sem restrições (Unrestricted).

Dica extra: Sincronização agendada e formato da mensagem de commit

Quando você terminar o assistente inicial, cairá na tela principal do GitSync. Recomendo fazer mais dois ajustes finos:

  1. Sincronização Agendada (Background): role a tela principal do GitSync até a seção Config. Sync Agendada, ative a chave Sincronização Agendada e escolha um intervalo (por exemplo, 1 hora ou 30 min). Assim, mesmo se você passar muito tempo com o Obsidian aberto, o GitSync garantirá backups periódicos em segundo plano:
Seção de Sincronização Agendada no GitSync configurada para sincronizar automaticamente a cada 1 hora
  1. Padronizar a mensagem de Commit: tocando no ícone de engrenagem ao lado do botão Enviar Alterações, você pode alterar o modelo da mensagem de commit (Sync Message) para seguir o mesmo padrão que configuramos no computador:
[Auto-Backup] %s | Dispositivo: Kaell Phone

Veja como fica o painel principal do GitSync no modo cliente (Client Mode), exibindo o histórico de commits, a branch MAIN, a autenticação ativa (AUTH) e o diretório local configurado:

Painel principal do GitSync exibindo o histórico de commits do celular, branch MAIN e diretório do cofre configurado

TIP

E como funciona a sincronização automática no iOS?

Como o iOS não permite que aplicativos monitorem a abertura de outros apps diretamente, no iPhone/iPad essa automação é feita pelo aplicativo nativo Atalhos (Shortcuts) da Apple:

  1. Abra o app Atalhos no iOS e vá na aba Automação > Nova Automação.
  2. Escolha o gatilho App, selecione o Obsidian, marque É Aberto e É Fechado, e escolha Executar Imediatamente.
  3. Adicione a ação do GitSync chamada Sync Repository e pronto!

5. Abrindo o cofre no Obsidian mobile e ativando a nossa pasta mobile

Agora que o GitSync já baixou nossas notas do GitHub para o celular e está pronto para sincronizar, falta apenas o toque final dentro do Obsidian Mobile: apontar para aquela pasta .obsidian-mobile que criamos lá na Parte 1.

  1. Abra o aplicativo do Obsidian no celular.
  2. Toque em Abrir pasta como cofre (Open folder as vault) e selecione a pasta do repositório que o GitSync clonou (ex.: obsidian/meu-diario-digital).
  3. O Obsidian exibirá um aviso perguntando se você confia no autor do cofre.

CAUTION

Toque em Navegar no cofre no Modo Restrito (isso porque não queremos vincular o plugin de git que utilizamos no desktop aqui para não causar instabilidade)

Aviso de segurança do Obsidian Mobile perguntando se confia no autor do cofre ou se deseja abrir no Modo Restrito
  1. Assim que o cofre abrir, toque no ícone de Configurações do Obsidian.
  2. Entre no menu Arquivos & Links (Files and links) e role até a seção Avançado.
  3. Localize a opção Sobrescrever pasta de configuração (Override config folder) e digite exatamente o nome da pasta mobile que criamos no computador

WARNING

Não esqueça do ponto no início

.obsidian-mobile
  1. Toque no botão roxo Reiniciar (Reload) que aparecerá ao lado do campo:
Configuração de Arquivos e Links no Obsidian Mobile com o campo Sobrescrever pasta de configuração preenchido com .obsidian-mobile

TIP

Por que esse passo resolve tudo?

Ao reiniciar, o aplicativo do celular passa a ler suas configurações e plugins exclusivamente da pasta .obsidian-mobile (ignorando a .obsidian do computador onde está o obsidian-git). Dessa forma, se você quiser instalar temas ou outros plugins da comunidade no celular, pode desativar o Modo Restrito tranquilamente sem risco de ativar o obsidian-git no mobile!

6. Testando a sincronização na prática

Tudo configurado! Vamos fazer o teste final:

  1. Com o Obsidian aberto no celular, abra a nota que você criou no computador (ex.: 2026-11-03-diario) e adicione uma nova linha: "Agora editei no Mobile!".
  2. Feche ou minimize o aplicativo do Obsidian (ou aguarde alguns segundos ao reabri-lo).
  3. Você verá um aviso flutuante na parte inferior da tela com o ícone do GitSync dizendo "Repositório sincronizado!":
Nota editada no Obsidian Mobile exibindo a notificação flutuante do GitSync de Repositório sincronizado

Em até 2 minutos (o tempo do Auto pull que configuramos no computador), a linha que você digitou no celular aparecerá automaticamente na tela do seu computador — e vice-versa!

Conclusão e boas práticas no dia a dia

Pronto! Agora você tem um ambiente completo do Obsidian sincronizado entre Linux, Windows, macOS e Android/iOS, 100% gratuito, privado e com todo o histórico de versões salvo no GitHub.

Recapitulando nossa arquitetura

  • No Computador: o plugin obsidian-git lê a pasta .obsidian e sincroniza automaticamente a cada 1 minuto via chave SSH.
  • No Celular: o app GitSync monitora a abertura e o fechamento do Obsidian (que lê a pasta .obsidian-mobile) e sincroniza tudo em segundo plano via OAuth.

Boas práticas e evitando conflitos de merges

  1. Espere a notificação do GitSync no celular: ao abrir o Obsidian no celular, aguarde os 2 ou 3 segundos até aparecer o aviso "Repositório sincronizado!" antes de começar a editar uma nota que você acabou de mexer no computador.
  2. Evite editar a mesma nota nos dois aparelhos ao mesmo tempo: se você terminou de escrever no computador, espere 1 minuto (ou acione o commit manual) antes de abrir a mesma nota no celular.
  3. Pastas de configuração independentes: lembre-se de que temas e plugins instalados no computador ficarão na .obsidian e os do celular na .obsidian-mobile. Se instalar um plugin novo no PC e quiser usá-lo no celular também, basta instalá-lo normalmente pela loja do Obsidian dentro do celular.

E você, como sincroniza suas notas?

E aí, deu tudo certo na sua configuração ou bateu alguma dúvida no meio do caminho? Se você teve alguma dificuldade em algum passo, ou se utiliza uma estratégia diferente para sincronizar o seu Obsidian entre dispositivos, deixe um comentário aqui embaixo!

Se este tutorial te ajudou a economizar tempo, não esqueça de curtir e compartilhar com quem também usa ou quer começar a usar o Obsidian. Até o próximo artigo!


Referências

0

Discussão (0 comentários)

Ilustração representando a área de comentários

Seja o primeiro a comentar!