Ton vault existant sur GitHub

Tu as déjà un vault rempli de notes (dans Obsidian, ou simplement un dossier de fichiers .md) ? Le chemin : créer un dépôt → y mettre ton vault → brancher le build. Aucun terminal nécessaire.

Étape 1 — créer un dépôt

1. Ouvre github.com/new.
2. Choisis un nom (il devient l'adresse : username.github.io/name).
3. Sélectionne Public (la version gratuite de GitHub Pages ne fonctionne qu'avec des dépôts publics ; s'il te faut un dépôt privé — publie plutôt via Netlify ou Vercel, ils buildent les dépôts privés gratuitement).
4. Create repository (créer le dépôt).

Étape 2 — téléverser ton vault

Sans git, directement dans le navigateur :

1. Dans le nouveau dépôt, clique sur uploading an existing file (téléverser un fichier existant).
2. Glisse le dossier de ton vault dans la zone de dépôt (les navigateurs acceptent des dossiers entiers).
3. Commit changes (valider les changements).

Recommandation : garde tes notes dans un dossier vault/ à l'intérieur du dépôt (pas à la racine) — les fichiers de configuration du build ne se mélangeront pas avec tes notes.

Étape 3 — brancher le build

1. Dans le dépôt : Add file → Create new file.
2. Dans le champ du nom, tape : .github/workflows/publish.yml (les barres obliques créent les dossiers).
3. Colle le contenu de publish.yml du template — il récupère automatiquement ton nom d'utilisateur et le nom du dépôt. Si tes notes ne sont pas dans vault/, modifie la ligne vault-dir: vault (pour la racine du dépôt, mets vault-dir: .).
4. Commit changes.
5. Active Pages : Settings → Pages → Source: GitHub Actions.
6. Onglet Actions → workflow « Publish site » → Run workflow.

En ~2 minutes, le site est en ligne à l'adresse username.github.io/repository-name. Prochaine étape — Comment mettre à jour le site.

Étape 4 — personnalise-le

Crée markdown-publish.config.json à la racine du dépôt :

{
  "siteName": "Mes notes",
  "siteLang": "fr",
  "vaultDir": "vault",
  "buildMode": "full"
}

• buildMode: "public" — ne publie que les notes avec publish: public dans leur frontmatter (tout le reste reste hors du site, de la recherche et du graphe).
• Toutes les autres clés : Configuration.