Retrouver ses notes sur tous ses appareils avec GitHub
Vos notes vivent sur une seule machine. Une idée capturée sur le téléphone ne rejoint jamais l'ordinateur, un pépin de disque peut emporter des années de réflexion, et les solutions de synchronisation toutes faites se paient à l'abonnement. Résultat : vous hésitez à noter, parce que vous ne savez jamais où la note va finir.
Cette masterclass vous donne la méthode en sept étapes pour synchroniser votre vault de notes (Obsidian ou un simple dossier de fichiers texte) sur tous vos appareils via un dépôt GitHub privé : sauvegarde automatique, historique complet, zéro abonnement payant.
Ce que cet exercice ne peut pas casser
L'exercice du jour se fait sur une feuille : vous ne tapez aucune commande, rien ne quitte votre machine. Et quand vous passerez à l'installation, le dépôt sera privé, visible par vous seul, et toute commande capable d'effacer ou d'écraser des données vous sera signalée avant d'être lancée.
Ce que vous saurez faire à la fin
- Retrouver vos notes à jour sur tous vos appareils, via un dépôt GitHub privé et gratuit.
- Protéger vos fichiers sensibles et vos médias lourds avec un .gitignore écrit avant le premier envoi.
- Dérouler les sept étapes dans le bon ordre, du dépôt privé au deuxième appareil, sans rien casser au passage.
- Niveau membre· le prompt prêt à coller qui génère votre marche à suivre personnalisée, votre .gitignore sur mesure et votre script de synchronisation.
- Niveau Pro· je monte la synchronisation avec vous, de la clé SSH au deuxième appareil, et je débloque vos pannes en direct.
L'ordre compte : le .gitignore avant le premier envoi, le test avant le deuxième appareil.
Sept étapes, et la peur que chacune neutralise
Une synchronisation qui marche du premier coup, ce n'est pas une question de talent technique : c'est une question d'ordre. Chacune des sept étapes neutralise une peur précise, et c'est leur enchaînement qui protège vos notes. Le .gitignore s'écrit avant le premier envoi, le test dans les deux sens se fait avant de brancher un deuxième appareil. Voici les sept marches, dans l'ordre.
1Créer le dépôt privédoute : « mes notes vont finir publiques ? »
Le dépôt, c'est votre espace de stockage en ligne sur GitHub. Privé, il n'est visible que par vous : personne d'autre n'y a accès. C'est lui qui garde l'historique complet de vos notes, gratuitement, sans abonnement.
2Initialiser Git et écrire le .gitignoredoute : « et mes fichiers sensibles ? »
Avant que quoi que ce soit parte en ligne, vous dressez la liste de ce qui ne partira jamais : notes confidentielles, fichiers sensibles, médias lourds. Cette liste, c'est le .gitignore, et elle s'écrit maintenant, jamais après le premier envoi.
3Connecter le dépôt distantdoute : « la clé SSH, c'est mon point noir »
Vous reliez votre machine au dépôt GitHub. C'est ici que vit la clé SSH, le point de friction le plus courant. Bonne nouvelle : une clé refusée fait partie des trois pannes classiques, avec un symptôme connu et une résolution en clair.
4Faire le premier envoidoute : « et si j'écrase quelque chose ? »
Vos notes partent en ligne pour la première fois, sauf ce que le .gitignore exclut. Règle de la méthode : toute commande capable d'effacer ou d'écraser des données est signalée avant d'être lancée. On n'envoie rien à l'aveugle.
5Installer et régler le plugin de synchronisationdoute : « je vais devoir y penser tous les jours ? »
Le plugin se règle une seule fois : intervalle de récupération, intervalle d'envoi, message de commit daté. À partir de là, la sauvegarde est automatique. Un script de synchronisation manuelle reste sous la main pour forcer une sauvegarde quand vous le décidez.
6Tester dans les deux sensdoute : « comment savoir que ça marche vraiment ? »
Une note modifiée sur la machine doit apparaître en ligne, une note modifiée en ligne doit revenir sur la machine. Tant que ce test n'est pas concluant dans les deux sens, on ne branche aucun autre appareil.
7Brancher le deuxième appareildoute : « et mon iPad ? »
Le deuxième appareil arrive en dernier, sur une base déjà testée. Les cas particuliers sont prévus : un iPad ou un iPhone passe par Working Copy, un vault lourd a sa gestion des gros fichiers.
À vous de jouer : votre inventaire de synchronisation
Prenez une feuille, trois colonnes. Cette feuille est la matière exacte que le prompt transformera en marche à suivre personnalisée.
Le prompt prêt à coller
# RÔLE Tu es un ingénieur système patient, spécialiste de Git et de la synchronisation de notes pour des personnes non techniques. Ton exigence : un résultat qui marche du premier coup, expliqué dans un langage qu'un débutant comprend. Tu ne t'appuies QUE sur ce que je te donne. Ce qui manque, tu me le demandes, tu ne l'inventes jamais. Si une commande peut effacer des données, tu me préviens avant. # CONTEXTE Je veux synchroniser mon vault de notes (Obsidian ou un simple dossier de fichiers texte) sur tous mes appareils via un depot GitHub privé, avec sauvegarde automatique et historique complet, sans abonnement payant. Mon inventaire de synchronisation (si je l'ai préparé) :
Le prompt vous interroge sur vos appareils et vos contraintes (ou rédige directement depuis votre inventaire), puis génère votre marche à suivre complète : commandes exactes pour votre système, .gitignore sur mesure, script de synchronisation et guide de dépannage des trois pannes classiques. Laissez votre email, je vous l'envoie.
Vérifiez que c'est à vous
Vous avez des notes confidentielles dans votre vault, votre dépôt GitHub privé vient d'être créé, et vous vous apprêtez à faire le premier envoi. Que faites-vous ?
D'abord avec vos mots, sans regarder les options :
Expliquez-le pour l'ancrer
En une phrase, à un collègue qui paie un abonnement de synchronisation : qu'est-ce qu'un dépôt GitHub privé apporte de plus à ses notes ? Si la réponse sort sans hésiter, c'est à vous.
Ce que vous savez faire maintenant
- Monter une synchronisation GitHub privée et gratuite, avec sauvegarde automatique et historique complet.
- Écrire votre .gitignore avant le premier envoi, pour que vos fichiers sensibles ne quittent jamais votre machine.
- Brancher un deuxième appareil sans rien casser : test dans les deux sens d'abord, Working Copy pour iPad et iPhone.
Vos notes sur tous vos appareils, avec sauvegarde automatique et historique complet, sans abonnement payant.
Faites-le avec moi
Je monte la synchronisation avec vous, appareil par appareil, jusqu'au test dans les deux sens. Vous repartez avec un système qui sauvegarde tout seul.