Aller à la documentation

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

  1. Ouvre Newral dans Chrome ou Edge sur ordinateur.
  2. Sélectionne Ouvrir un dossier, puis choisis un dossier existant ou crée-en un depuis le sélecteur du système.
  3. Autorise l’accès en lecture et écriture. Newral charge immédiatement l’arborescence des fichiers .md.
  4. Crée une première note depuis l’accueil ou le bouton de la barre latérale.
À savoir
Le dossier n’est pas importé dans Newral : il reste à son emplacement d’origine. Pour passer à un autre coffre, ouvre Réglages → Changer de dossier. Si le navigateur conserve son autorisation, Newral rouvre automatiquement le dernier coffre sur ce même navigateur ; sinon il te demande de l’autoriser à nouveau.

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.

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.

  1. 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.
  2. Dans Newral, clique « Utiliser avec GitHub ». Le bouton est sur l’écran d’accueil, à côté de « Ouvrir un dossier », et sur le site.
  3. Connecte-toi à GitHub et autorise Newral à t’identifier. Cette étape ne donne encore accès à aucun fichier.
  4. 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.
  5. 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é.
  6. É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.
Deux réflexes
Édite depuis un seul endroit à la fois : si la branche a bougé ailleurs entre-temps, Newral refuse d’écraser ce travail et il faut rouvrir le dépôt pour repartir de la version à jour. Et attends que l’indicateur d’enregistrement soit au vert avant de fermer l’onglet.

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.

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.

Source du graphe
Chaque relation détectée devient une arête du graphe. Les backlinks et la vue graphique racontent donc le même réseau, sous deux formes différentes.

06 / 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.

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.

Glisser une note
Dépose-la au centre pour l’ouvrir dans le panneau principal ; la zone de droite, matérialisée par une cellule hachurée teintée, prévisualise l’ouverture en vue scindée.

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.

Graphe vide
Des notes sans relation ne suffisent pas à raconter un réseau. Commence par citer une note dans une autre : la première arête apparaîtra automatiquement.

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

  1. 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.
  2. 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.
  3. 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.

Format ouvert
Une map est un fichier .map (JSON versionné, lisible) rangé dans ton coffre et synchronisé comme le reste. Une map apparaît dans le graphe comme un nœud, relié à chaque note qu’elle cite ; quand une note est renommée, les blocs qui la citent sont réécrits comme les liens wiki.

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.

Où vivent les calendriers
Un calendrier est un fichier .calendrier (JSON versionné, lisible) rangé dans .newral/calendriers/. Il n’apparaît donc ni dans l’arborescence ni dans la recherche : on l’ouvre depuis la vue Calendrier, pas depuis l’arbre du coffre. Il apparaît en revanche dans le graphe, comme un nœud relié à chaque note que ses événements citent, et dans le panneau Notes liées de ces notes — un clic y ramène à la vue Calendrier. Le mettre à la corbeille fonctionne comme pour n’importe quel document, et il revient exactement d’où il vient. Un fichier illisible ou écrit par une version plus récente de Newral est signalé et jamais réécrit. Les événements récurrents ne sont pas encore gérés : chaque occurrence est un événement à part.

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.

En cas d’échec
Sur le web, vérifie le navigateur et l’autorisation accordée. Sur Windows, vérifie que le dossier mémorisé existe encore et que tu peux y écrire. Si un fichier change depuis un autre logiciel, utilise le bouton Rafraîchir avant de poursuivre.

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

Ton dossier est la source de vérité. Newral est l’atelier autour.

Créer