Second cerveau · Mode d’emploi
Newral, de tes premiers fichiers à ton graphe de connaissances.
Cette documentation suit le chemin réel du produit : ouvrir un dossier local ou un dépôt GitHub, écrire, relier, organiser puis explorer ses notes. Aucun compte Newral, aucun format propriétaire entre tes idées et toi.
Application bureau · Chrome et Edge · Fichiers .md
01 / Bien démarrer
Commencer avec des fichiers qui t’appartiennent déjà.
Dans Newral, un dossier local ou un dépôt GitHub joue le rôle de coffre. Tu choisis le stockage, puis l’application affiche les fichiers markdown qu’il contient.
Ouvrir ton premier coffre
- Ouvre Newral dans Chrome ou Edge sur ordinateur.
- Sélectionne Ouvrir un dossier, puis choisis un dossier existant ou crée-en un depuis le sélecteur du système.
- Autorise l’accès en lecture et écriture. Newral charge immédiatement l’arborescence des fichiers .md.
- Crée une première note depuis l’accueil ou le bouton de la barre latérale.
L’autre stockage : un dépôt GitHub
Un coffre peut aussi être un dépôt GitHub privé : les mêmes fichiers markdown, versionnés, disponibles depuis plusieurs machines. La marche à suivre tient dans le chapitre suivant, Synchronisation GitHub.
Mon dossier
Idées.md
Mémoire de travail.md
Projets
Newral.md
Mémoire de travail.md
---
created: 2026-07-18
tags: [cognition]
---
Elle retient 4 éléments, pas plus. Voir [[Attention]].
02 / Synchronisation GitHub
Ouvrir un dépôt GitHub comme coffre, en six étapes.
Un dépôt GitHub privé remplace le dossier local : mêmes fichiers markdown, mêmes fonctionnalités, avec un historique et l’accès depuis plusieurs machines. Newral parle directement à l’API de GitHub depuis ton navigateur ; aucune note ne transite par un serveur Newral.
- Crée un dépôt privé sur ton compte GitHub. Bouton New repository, visibilité Private. Newral ne le crée pas à ta place. Laisse-le vide : il sera initialisé au premier enregistrement.
- Dans Newral, clique « Utiliser avec GitHub ». Le bouton est sur l’écran d’accueil, à côté de « Ouvrir un dossier », et sur le site.
- Connecte-toi à GitHub et autorise Newral à t’identifier. Cette étape ne donne encore accès à aucun fichier.
- Clique « Autoriser un dépôt ». GitHub propose d’installer l’app Newral : choisis Only select repositories et coche uniquement le dépôt créé à l’étape 1. Elle demande le droit Contents : Read and write, pour lire tes notes et enregistrer tes modifications.
- Reviens dans Newral et choisis le dépôt. Clique Actualiser si la liste est encore vide. Chaque dépôt s’affiche avec sa branche par défaut, et un cadenas s’il est privé.
- Écris. Tes modifications partent en commits groupés sur la branche par défaut, quelques secondes après ta dernière frappe. Le reste de Newral ne change pas d’un pouce.
3 notes · 1 commit
03 / Notes et dossiers
Créer, classer et déplacer sans perdre le fichier de vue.
La barre latérale reflète le stockage choisi. Une note est un fichier markdown ; un dossier reste un dossier. Les actions de rangement modifient directement cette structure.
Créer une note. Elle est créée à la racine du coffre, puis s’ouvre dans un onglet.
Créer un dossier. Crée-le à la racine ou depuis le menu contextuel d’un dossier parent.
Renommer. Le titre d’une note et le nom de son fichier restent une seule et même chose.
Dupliquer. Une copie unique est créée dans le même dossier, y compris pour une arborescence complète.
Déplacer. Glisse une note sur un dossier, ou utilise « Déplacer vers… » pour choisir précisément la destination.
Mettre à la corbeille. Rien n’est effacé : le document rejoint la corbeille, d’où il revient à sa place d’origine. La suppression définitive ne se demande que depuis la corbeille elle-même.
La note du jour
Le bouton « Note du jour », ancré en bas de la barre latérale sur ordinateur et sur l’accueil au téléphone, ouvre la note datée d’aujourd’hui, et la crée dans un dossierJournal si elle n’existe pas encore. Son titre est la date au format2026-08-04, qui se trie tout seul dans l’ordre chronologique.
C’est une note comme les autres : tu peux la déplacer, la ranger par mois, la renommer. Elle est retrouvée par son titre, comme un lien [[…]], donc le bouton rouvrira toujours celle du jour où qu’elle soit rangée, au lieu d’en créer une seconde.
Le menu contextuel
Un clic droit sur une note permet de l’ouvrir dans un nouvel onglet ou dans le panneau droit, de la dupliquer, déplacer, mettre en marque-page, copier son chemin, renommer ou supprimer. Sur un dossier, le même menu ajoute la création d’un sous-dossier.
Trier et rafraîchir
L’arborescence peut être triée par nom ou par date de modification, dans les deux sens. Le bouton de rafraîchissement relit le disque lorsque des fichiers ont été modifiés en dehors de Newral ; « Tout replier » referme l’ensemble des dossiers ouverts.
04 / Éditeur par blocs
Écrire comme dans un éditeur par blocs, conserver du markdown propre.
Le corps de la note est édité visuellement avec Tiptap. Newral le sérialise ensuite en markdown, sans te demander de manipuler la syntaxe au quotidien.
Le menu « / »
Tape / au début ou au milieu d’un paragraphe, puis filtre la commande par son nom.
- Texte, titres de niveaux 1 à 3.
- Listes à puces et listes numérotées.
- Liste de tâches avec cases à cocher imbricables, écrite en markdown standard (- [ ] / - [x]), donc relisible par n’importe quel autre éditeur.
- Citation, bloc de code et séparateur horizontal.
- Tableau 3 × 3 redimensionnable, avec ligne d’en-tête compatible GFM.
- Image (PNG ou JPEG), depuis le menu, en collant une capture d’écran ou en glissant un fichier. Elle est enregistrée dans le coffre (dossier attachments).
- Lien vers une note, qui passe la main au sélecteur [[…]].
Dans un tableau, fais un clic droit sur une cellule pour afficher l’action « Supprimer le tableau ». Partout ailleurs dans le texte, le menu contextuel natif reste disponible pour la copie, le collage et la correction orthographique.
Titre, sauvegarde et état
Clique dans le grand titre pour renommer la note. Entrée valide, Échap annule. Le contenu est enregistré automatiquement après la frappe ; l’indicateur en haut à droite signale le chargement, l’enregistrement, le succès ou une erreur d’écriture.
Ce matin j'ai compris /
zéro raccourci à retenir
05 / Liens et backlinks
Relier une idée sans interrompre l’écriture.
Newral sait reconnaître le titre d’une note dans une phrase. Il conserve aussi les liens wiki explicites quand tu veux choisir la destination ou préparer une note qui n’existe pas encore.
Deux façons de créer un lien
- Lien automatique. Écris le titre exact d’une autre note : la mention devient cliquable et rejoint cette note.
- Lien explicite. Tape [[ ou choisis « Lien vers une note » dans le menu /. Le sélecteur propose les notes existantes et peut préparer une nouvelle cible.
Backlinks et renommage sûr
En bas de chaque note, le panneau « Notes liées » liste les notes qui la mentionnent avec un extrait de contexte nettoyé du markdown. Quand une note est renommée, Newral réécrit ses liens wiki entrants dans les fichiers qui ne sont pas en cours d’édition.
Sous pression, la mémoire de travail sature en premier.
Mémoire de travail.md
1 note liée06 / Propriétés et organisation
Ajouter juste assez de structure pour retrouver le fil.
Les propriétés décrivent la note sans l’enfermer. Les tags construisent des vues transversales ; les marque-pages gardent les documents importants à portée de clic.
Propriétés d’une note
Sous le titre, Newral affiche la date de création, la dernière modification, le nombre de mots et les tags. Les dates et tags sont conservés dans le frontmatter ; les clés inconnues déjà présentes y sont préservées lors des sauvegardes.
Tags navigables
Ajoute ou retire un tag depuis les propriétés. Tous les tags du coffre apparaissent dans la barre latérale avec leur nombre de notes. Un clic ouvre un onglet dédié à la sélection.
Marque-pages du coffre
Épingle une note depuis son menu contextuel. Son chemin relatif est ajouté à .newral/config.json ; le marque-page voyage donc avec le dossier, sans modifier le fichier Markdown. Il suit la note lorsque celle-ci, ou l’un de ses dossiers parents, est renommée ou déplacée.
Mémoire de travail
Les propriétés sont écrites dans le frontmatter du fichier markdown.
07 / Onglets et vue scindée
Faire circuler les notes entre onglets et panneaux.
L’espace de travail reprend les habitudes d’un navigateur : plusieurs onglets, un ordre libre et, lorsque deux idées doivent rester visibles ensemble, une vue scindée redimensionnable.
Accueil et onglets
L’accueil montre jusqu’à cinq notes récemment modifiées. Chaque note s’ouvre dans un onglet ; tu peux en créer plusieurs, les réordonner par glisser-déposer et les fermer séparément.
Navigation globale
Le rail le plus à gauche se déplie au survol et donne accès au dossier, au graphe et aux réglages. La barre des fichiers adjacente est redimensionnable ; sa largeur est mémorisée dans la configuration du dossier pour la prochaine session.
Vue scindée
Choisis « Ouvrir vers la droite », utilise le bouton de division de la barre d’onglets ou dépose une note sur le bord droit de l’espace. Le second panneau possède ses propres onglets et sa propre recherche. Fais glisser le séparateur pour régler sa largeur.
Mémoire
Attention
chaque panneau garde ses onglets
08 / Recherche
Retrouver une note avant de perdre l’idée suivante.
La palette cherche dans les titres et dans le contenu des notes, montre un extrait autour de chaque correspondance, puis ouvre immédiatement le résultat choisi. Elle est disponible depuis la barre latérale, l’accueil et chaque panneau.
Ouvrir la palette
Utilise ⌘ K sur macOS ou Ctrl K sur Windows et Linux. La même commande referme la palette si elle est déjà ouverte.
Chercher dans le texte
Tape un mot dont tu te souviens plutôt qu’un titre : la recherche lit le corps des notes et le texte des cartes d’une map, et affiche l’extrait qui l’entoure. Les accents sont ignorés dans les deux sens, si bien que « securite » trouve « sécurité ». Plusieurs mots se cumulent : tous doivent apparaître, dans le titre ou dans le texte.
Choisir le bon panneau
La recherche globale ouvre la note dans le panneau principal. Une recherche lancée depuis l’accueil d’un panneau scindé conserve ce contexte et ouvre le résultat dans ce même panneau.
09 / Graphe 2D et 3D
Lire le réseau, puis revenir au texte.
Chaque note devient un nœud et chaque mention une connexion. Le graphe sert à explorer les voisinages, repérer les notes isolées et ouvrir un document sans repasser par l’arborescence.
Vue 2D
- Survole un nœud pour conserver son voisinage au premier plan et estomper le reste.
- Clique sur un nœud pour ouvrir la note correspondante.
- Fais glisser un nœud, zoome à la molette et utilise « Recentrer » pour retrouver l’ensemble du réseau.
Vue 3D
Le sélecteur 2D/3D conserve la même physique et les mêmes relations. En 3D, le clic gauche pivote la scène, la molette zoome et le clic droit la déplace. Les libellés restent sobres et le voisinage survolé s’allume de la même manière.
10 / Maps (tableau blanc)
Poser les idées côte à côte sur un tableau blanc.
Une map est un canevas libre enregistré dans le coffre, à côté des notes. On y dispose des blocs, on les déplace, on les redimensionne, pour cartographier un projet sans imposer de structure au texte lui-même.
Créer et retrouver une map
- Ouvre le menu Fichier en haut de la barre latérale et choisis Map, ou survole le rail de navigation à gauche et choisis Nouvelle Map, ou fais un clic droit dans la zone libre de la barre latérale.
- La map est créée à la racine du coffre sous un nom libre (« Nouvelle map ») et s’ouvre dans un onglet. Renomme-la comme une note, depuis son menu contextuel.
- Retrouve-la dans l’arborescence avec son icône dédiée, dans la recherche (groupe « Maps »), ou épingle-la en marque-page.
Trois types de blocs
- La carte. Un bloc de texte libre, doté du même éditeur que tes notes. Double-clique dessus pour écrire, puis tape / pour insérer un titre, une liste, un tableau, une image… Cite une page avec [[…]] ou en tapant simplement le titre exact d’une note : la mention devient cliquable.
- La note du coffre. Une note incrustée sur la map, en lecture seule : titre, propriétés et contenu avec le même rendu que l’éditeur. Un bouton ouvre la note complète dans un onglet.
- Le média. Une image (PNG ou JPEG) posée sur le canevas depuis la barre d’outils, le clic droit ou en glissant un fichier. L’image est enregistrée dans le coffre (dossier attachments) et référencée par un chemin relatif, comme dans les notes.
Naviguer et organiser
La molette déplace le canevas et Ctrl + molette zoome vers le curseur. Un double-clic sur le fond pose une carte, un glisser la déplace, les poignées la redimensionnent, et Suppr retire le bloc sélectionné. En déplaçant un bloc, des repères corail apparaissent dès qu’un bord ou un centre s’aligne sur un autre bloc, et le déplacement s’y accroche, comme dans un outil de design.
Une seule barre d’outils réunit tout : ajouter des blocs, zoomer, recadrer, et un menu de réglages. Depuis ce menu tu la passes horizontale ou verticale, et tu la rends déplaçable : elle affiche alors une poignée à six points pour la poser où tu veux, sinon elle reste accrochée au bord. Le même menu magnétise les déplacements sur la grille ou fige la map en lecture seule. Le clic droit reste disponible pour ajouter un bloc à l’endroit visé ; le clic droit sur un bloc l’ouvre, le modifie, le duplique ou le supprime.
chaque map reste un fichier du coffre
11 / Calendrier
Voir ce qui vient, pas seulement ce qui a été écrit.
Le calendrier est la lecture prospective du coffre, en vis-à-vis de la chronologie qui en est la lecture rétrospective. On y tient plusieurs calendriers — pro, perso, rendez-vous — qui se superposent dans une même vue.
Créer un calendrier, puis des événements
- Ouvre la vue depuis l’icône de calendrier, dans le pied de la barre latérale, à côté de la chronologie et du graphe. Sur téléphone, elle s’atteint depuis l’en-tête de l’accueil.
- Le premier écran ne propose qu’un geste : Créer un calendrier. Un titre suffit ; deux calendriers peuvent porter le même sans que ce soit une erreur.
- Double-clique sur un jour, ou sur un créneau dans les vues Semaine et Jour, pour ouvrir la fiche d’un nouvel événement. L’heure cliquée est déjà remplie.
- Un clic sur le nom d’un calendrier, dans la légende, l’allume ou l’éteint. Éteint, son nom recule au lieu de disparaître : on sait qu’il existe encore.
Trois échelles, une seule ancre
Mois, Semaine et Jour partagent le jour que tu regardes : changer d’échelle ne te renvoie pas à aujourd’hui. Une case garde la même taille d’une échelle à l’autre — les hauteurs sont des minimums, donc la grille remplit la fenêtre quand il y a de la place et défile quand il n’y en a plus, sans jamais écraser une heure.
Les vues horaires n’affichent pas vingt-quatre heures vides : elles montrent les heures ouvrées et s’étendent d’elles-mêmes jusqu’à contenir ce que tes journées portent réellement. Un vol à 5 h du matin ne peut donc pas être caché. Un repère marque l’heure courante.
Déplacer, étirer, supprimer
- Glisser un événement le déplace d’un jour à l’autre en gardant sa durée, y compris s’il traverse minuit.
- Glisser son bord haut ou bas change cette borne-là sans toucher l’autre. Les deux gestes s’aimantent au quart d’heure, et rien n’est écrit dans le fichier avant que tu ne relâches.
- Double-clic ouvre la fiche d’un événement — jamais le simple clic, qui appartient au déplacement. Clic droit propose Modifier et Supprimer.
- Plusieurs événements à la même heure se partagent la largeur du jour, par groupe de chevauchement : un rendez-vous de huit heures ne rétrécit pas les créneaux du soir qui ne croisent personne.
Couleurs et liens vers les notes
La couleur appartient à l’événement, pas au calendrier : un créneau se met en bleu parce qu’il est de cette nature-là, pas parce qu’il vient de « Pro ». Sept teintes sont proposées, choisies pour rester lisibles sur leur propre fond dans les deux thèmes ; le corail n’en fait pas partie, il reste réservé à l’action principale de l’interface.
La fiche d’un événement cherche dans les notes du coffre et les référence par leur titre, comme un lien wiki : déplacer la note ne casse rien. Sa description accepte du texte libre, où les titres de notes sont écrits tels quels.
12 / Données et compatibilité
Savoir exactement où vivent les données.
Newral n’a ni backend de notes ni compte propre. Le mode local passe par la File System Access API ; le mode GitHub échange directement avec l’API GitHub.
Ce qui est écrit dans les fichiers
Le nom du fichier porte le titre. Le frontmatter contient notamment la date de création et les tags ; le corps reste du markdown standard, avec des liens wiki lorsque tu les utilises. Tu peux donc lire et sauvegarder le coffre avec d’autres outils.
La configuration du dossier
Newral crée un fichier .newral/config.json dans le dossier ouvert. Il regroupe les chemins relatifs des marque-pages, l’ordre de tri et les largeurs de la barre latérale et du panneau droit. Le sous-dossier .newral est masqué dans l’arborescence de l’application et ignoré par la recherche comme par le graphe. Tu peux le sauvegarder ou le synchroniser avec le reste du coffre pour retrouver le même espace de travail ailleurs.
Le dernier coffre dans ce navigateur
Newral conserve dans l’IndexedDB du navigateur uniquement le handle du dernier coffre, pas son chemin absolu ni le contenu de ses notes. Si l’autorisation lecture-écriture est encore accordée, il est rouvert automatiquement. Sinon, tu dois confirmer sa réouverture ou choisir un autre dossier. Les réglages de l’espace de travail restent dans .newral/config.json.
Le mode GitHub
Les fonctions Vercel de Newral gèrent uniquement l’authentification et les jetons temporaires. Le contenu des notes circule directement entre ton navigateur et GitHub. Newral refuse d’écraser la branche si elle a avancé depuis son ouverture : recharge le dépôt pour intégrer les changements distants avant de réessayer. Tes notes restant personnelles, conserve le dépôt en visibilité privée.
Migration des anciennes préférences
Lors de la première ouverture après cette évolution, Newral reprend les préférences encore présentes dans le stockage du navigateur et écrit le nouveau fichier. Les anciennes clés ne sont supprimées qu’après une écriture réussie. Un fichier existant mais invalide ou créé par une version plus récente n’est jamais remplacé silencieusement : l’application le signale afin que tu puisses le corriger.
Compatibilité et sauvegarde
Utilise Chrome ou Edge : Firefox, Safari et les navigateurs mobiles n’exposent pas l’accès requis. Newral ne remplace pas une sauvegarde : copie ou synchronise toi-même le dossier avec la solution de ton choix si tu veux une redondance.
Mon dossier
Idées.md
Mémoire de travail.md
Projets
Newral.md
Mémoire de travail.md
---
created: 2026-07-18
tags: [cognition]
---
Elle retient 4 éléments, pas plus. Voir [[Attention]].
13 / Raccourcis clavier
Des commandes visibles avant d’être mémorisées.
La recherche, l’édition et les actions globales répondent au clavier. Les combinaisons Note, Dossier et Onglet incluent Alt : les navigateurs réservent les variantes nues (⌘ N, ⌘ W…) à leurs propres fenêtres et onglets.
- Ctrl KOuvrir ou fermer la recherche globale
- Ctrl Alt NCréer une nouvelle note
- Ctrl Alt ⇧ NCréer un nouveau dossier
- Ctrl \Ouvrir ou fermer la vue scindée
- Ctrl GOuvrir le graphe
- Ctrl Alt WFermer l’onglet actif
- /Ouvrir le menu de blocs dans l’éditeur
- [[Choisir ou préparer une note liée
- ↵ / EscValider ou annuler le renommage du titre
Fin du manuel