Cours obsidian

title: Gérer ses prises de notes efficacement : Obsidian, mon deuxième cerveau
author: Raphaëlle Bats
date: juin 2022 (V1) - Octobre 2022 (V2) - Mars 2025 (V3)

Obsidian ?

Qu'est-ce que c'est ?

Obsidian est un outil de prises de notes. On parle de knowledge base.
S'appuie sur une méthode qu'on appelle Zettelkasten
Zettelkasten = boîte de notes
Enjeu : faire des liens entre des notes, grâce à des métadonnées associées à chaque note.

Zettelkasten

Cette méthode des liens ne vient pas de nulle part. Elle s'appuie sur un méthode appelée
Zettelkasten, élaborée par Niklas Luhman, chercheur en sociologie et philosophie entre les
années 1960 et 1990.

Niklas Luhman
Source : [Link]

Luhman avait près de 90000 fiches, à partir desquelles il a pu écrire un nombre

impressionnant d'articles.

Mieux comprendre Zettelkasten et les différents types de notes : The Zettelkasten Method:
Examples to help you get started. | by Rebecca Williams | Medium

A quoi ça sert ?
gérer mes notes de lecture
carnet de recherche
travail collaboratif / gestion de projets
écriture d'articles
prise de notes de réunion
Pourquoi je l'utilise plutôt qu'un autre outil ?
Efficacité :

Simplicité : interface / Markdown

Liens : Obsidian invite à rédiger des notes de lectures bien organisées, et si je passe un
temps fou à analyser et commenter les textes, parce que je suis déjà dans une phase de pré-
écriture, mais je gagne du temps au moment de l'écriture. Mes analyses sont construites au
fur et à mesure et non quand j'essaye d'écrire, et elles sont vraiment plus riches.

Conservation des notes

Outil unique : Avant mon usage d'Obsidian, j'ai perdu plein de notes de lectures, qu'il va
falloir que je recommence à lire et à rédiger, parce qu'évidemment, c'est maintenant que
j'en ai besoin.

Mémoire

Liens internes et leur visualisation en graphs : Clairement, grâce à la vue graphique et aux
liens, je retrouve des liens que mon cerveau a fait et que j'avais oubliés. Peu à peu, se
dessine vraiment le système de pensée que j'essaye de développer et de le voir est hyper
excitant.
Voir à ce sujet la vue graphique en mode historique.

Multiusage

J'utilise Obsidian pour une foule de chose : gestion de projet, notes de lecture, CR de
réunion, rédaction d'articles, etc. Pour mes articles, j'ai tendance à faire le premier jet sur
Obsidian, puis à travailler sur Zettlr (plus propre notamment pour Zotero). Quand je veux
écrire un article, je pioche dans mon Obsidian pour retrouver à la fois ce que j'ai lu, mais
aussi ce que j'ai analysé et plus encore les liens bidirectionnels que j'avais faits mais
souvent oubliés. Puis je finalise mon article sur Zettlr, dans lequel j'ai déjà mon plugin
Pandoc, ce qui me permet de le sortir dans le format souhaité. Cela peut paraître
redondant, mais pour l'instant, ça me va bien comme ça.

Obsidian
Qui le propose ?
Shida Li et Erica Xu, University of Waterloo : Computer Science / Software Ingeneering

Obsidian spécificités
Quelle est la spécificité de Obsidian ? La volonté des créateurs :
 Local-first and plain text : on va parler téléchargement, synchronisation, puis Markdown
Link as first-class citizen : on va parler de liens bidirectionnels
Make it super extensible : on parlera des plugins

En savoir plus sur Obsidian : [Link]

Coût
Logiciel Gratuit, mais pas open source.

Tarifs :

J'utilise la version gratuite.

Installation
Download Obsidian for Windows

Also available for macOS, Linux (AppImage), Linux (Snap), and Linux (Flatpak). More
platforms.
Possibilité d'avoir une version mobile et d'avoir une synchronisation sur plusieurs postes,
mais cela a un coût. La version mobile peut-être utile si vous utilisez Obsidian pour en faire
un carnet de terrain, par exemple.

Obsidian Sync

Si vous enregistrez vos coffres et notes sur un serveur (type NAS/UB Cloud...), vous pouvez
utiliser Obsidian depuis un autre ordinateur sans avoir besoin de synchroniser et vous
pouvez aussi partager votre obsidian.

Démo : montrer mon serveur.

Apparence
Version ordi et version mobile

Organisation
Structure
Coffre / Vault
Ouvrir un coffre

Où ça se range ?
Dans votre ordinateur, là où vous le souhaitez.

Sécurité des coffres

[Link]
la solution propose d'encrypter le dossier mais ce n'est pas géré par obsidian / d'encrypter
un coffre et de le protéger avec un mot de passe

Note : je n'ai pas trouvé combien de coffres max.

Multiplier les coffres

Au début, j'avais des coffres pour mes grands projets de recherche, mais je ne peux pas faire
de liens entre des notes de coffres différents (ou je ne sais pas faire), donc j'ai tout mis dans
le même coffre, parce qu'au fond ces projets de recherche se nourrissent l'un de l'autre.

Dossiers

Ouvrir un dossier
Directement dans l'interface d'Obsidian ou depuis le lieu de rangement de votre coffre.

Note

Ouvrir une note

C'est un document en markdown : .md
Il est possible de l'ouvrir avec n'importe quel éditeur markdown.

Interface de la note :
Sur Obsidian, le titre de la note est aussi le nom du document.

En haut de note, vous avez un rappel de l'adresse du fichier.

En haut de la note à droite, vous avez un les icônes suivantes :

Le livre signifie que vous êtes en mode édition. Lorsque vous êtes en mode lecture, un stylo
apparaît et vous permet de passer en mode édition.

Les trois points ouvrent sur une sélection de commandes. Les commandes sont également
accessibles en faisant CRTL + P.

Attention pour mode lecture et source. Si vous décochez les deux, vous pouvez modifier
votre page tout en la faisant apparaître en mode lecture. Sinon, vous ne pourrez modifier
qu'en mode édition.
En bas de la note, le nombre de signe : il change en fonction du texte que vous sélectionnez.
Vous pouvez ouvrir plusieurs pages en même temps, soit en fractionnant la page, soit en
ouvrant un autre onglet.

A droite des onglets, l'icone suivante permet d'ouvrir la fenêtre latérale droite.

La fenêtre latérale propose par défaut les quatre éléments ci-contre :

Le premier est celui des retroliens de la page.

Le second est celui des liens sortants de la page.
Le troisième est celui des tags du coffre
Le quatrième est la table des matières de votre note.

Canva

Vous pouvez ouvrir un canva. Ce sont des pages dédiées à de la visualisation des idées, des
liens, des notes, etc.

Un exemple :
Un autre exemple :

Pour ouvrir un canva :

CRTL + P : taper canva et choisir : "créer une nouvelle toile.

Ou dans la barre latérale de gauche, cliquer sur l'icone suivante:

Apparence :
Les thèmes

Paramètres > Apparences > Manage

Fenêtres

On peut dédoubler verticalement et horizontalement en passant par les commandes de la

note (les trois points verticaux) ou par la barre de commande.
Fractionner vers la droite
Fractionner vers le bas :

Rédiger des notes

Ecrire
A la base on écrit en markdown, mais on peut ajouter du html, du javascript et du CSS.
CSS : permet de modifier les feuilles de style. Je ne vais pas en faire la démo.
Html : va permettre d'améliorer des choses qui ne sont pas optimales en markdown, ex : les
tableaux.
Possibilité d'insérer iframe : copier-coller l'iframe

Marche avec youtube et tout ce qui a une iframe, et par exemple Pomodoro !

Markdown

Markdown est un langage à balisage léger.

Documentation Markdown

Tutoriel Markdown : [Link]

Basic Formatting Syntax : [Link]
Markdown for Obsidian : [Link]
Markdown Basics : [Link]
Obsidian basics : [Link]

Ecrire en Markdown

Markdown

Elements de base
Métadonnées

cliquer sur les

Puis sur Ajouter des propriétés de fichier

Les métadonnées viennent se mettre en haut de la page. Vous pouvez choisir les
propriétés de votre choix.

Attention les propriétés ne se voient pas quand on affiche une note dans une autre note.

Titres et tags
Des # pour les titres et pour les tags. La différence : l'espace entre le # et le mot.

Tags : sans espace :

#markdown
#prise_de_note

Titres : un espace

1 # = Titre 1
2 # = Titre 2
3 # = Titre 3
Etc.

Apparence
gras, italique, taille, couleur, etc.

surlignage : == mot sans espace ==

italique : mot sans espace ou mot sans espace

gras : mot sans espace ou mot sans espace

*un texte en italique et en gras.

ou italique et gras

Organisation
Les listes à puces :

Ecrire une astérisque, un tiret ou un signe "+", suivi d'un espace et du texte : et la puce se
met automatiquement.

item
item 2
item 3

On peut mettre du gras et de l'italique dans les puces.

item
item 2
​ ital
**gras

Pour faire des niveaux de puce, ajouter des espaces avant la puce.
 item
​ item 2
item 3

Liste hiérarchisée numérique

Ecrire le numéro + un point, suivi d'un espace et du texte, et la liste se met en place
automatiquement

1. item1
2. item 2
3. item 4

On peut écrire du texte sous chaque point. Au point suivant, il remet la numérotation au
point 1, mais on peut le modifier et mettre la numérotation souhaitée (à condition d'avoir
sauté une ligne et recommencer un texte).
5. item
Ici j'écris un texte

6. item2
ici j'écris un texte

.
6. item 5
Ici j'écris un texte.

Liste de Tâches

Créer une liste de tâches :

1. Mettre une puce

2. Espace + ouvrir des crochets
3. Laisser un espace dans les []
4. Espace + Ecrire le texte

item 1
item 2
item 3

Pour cocher : en mode aperçu : cliquer sur la case. en mode éditeur : ajouter une croix

item
item 2
Liens
Mettre le nom dans les crochets [], puis le lien entre parenthèse ().

Exemple :
Cours Obsidian tuto
titre

LIEN

vidéos et photos
vidéos

avec une iframe : copier-coller l'iframe

PDF

juste glisser et déposer

“[Link]” ne peut être trouvé.

Images
Plusieurs solutions :

!
[] le nom de l'image
() l'adresse de l'image

son adresse sur votre ordi

son adresse depuis une page web (attention, si vous oubliez le !, alors il y aura un lien
et non l'image)

Exemple :

Image : avec le !
Lien : sans le !
Logo Urfist Bordeaux

A noter qu'on peut copier-coller directement une photo trouvée sur le web ou copier
coller directement depuis l'ordi en faisant glisser l'image. Il ajoute alors l'image dans le
Vault/coffre.

Citations et encadrés
Commencer la citation par >

ma jolie citation
-\auteur, date

texte qu'on cite

- Nom, date

Pour les auteurs : -

On peut aussi lier une notice Zotero, voir le cours Formation-Obsidian-Juin2022

Pour faire de beaux encadrés, commencer par le ">" de la citation et mettre des
indications de présentation du texte. Exemples :

jkdsgjklfjklgsjklhklfdjhklfdjhl

[!QUESTION]

Pour faire de belles citations : ajouter le texte après > [!QUOTE]

Texte de la citation

Pour faire un encadré : mettre le texte entre > [!...]

Ici, je veux mettre quelque chose d'important

Point info : >[!Info]

: Le gouvernement utilise le 49.3

Avec : >[!ABSTRACT]

ceci est un résumé

Avec : >[!IMPORTANT]
 Ceci est important

Avec > [!TODO]

ceci est à faire

Avec > [!QUESTION]

ça c'est une bonne question

Avec : > [!DONE]

Une bonne chose de faite !

Avec : >[!EXAMPLE]

Voilà un exemple pertinent

Notes de bas de page

Et pour les notes de bas de page : [] et dans les crochets ^ suivi d'un numéro ou d'un
mot[1]

concept [2]

exemple [2-1] 1 [1-1]

ici je parle de markdown [3]

Exemple 2[4]

Exemple 3[5]

Autre
Pour écrire : vingt et unième : XIXe : mettre le "e" entre les balises < sup> et la balise <
/sup>. Attention, pas d'espace entre "< ou >" et le texte à l'intérieur des crochets.

CTRL P : pour trouver d'autres balises Markdown.

 Tableau
colonne 1 colonne 2 colonne 3
item 1 item 2 item 3

|
|||

1. hdsjhksdhgjhsjkdghjksdhjgkshjk ↩︎ ↩︎
2. test ↩︎ ↩︎
3. Markdown est un langage à balisage léger.. ↩︎
4. une deuxième note de bas de page ↩︎
5. ceci est un exemple avec un mot clé plutôt qu'un numéro ↩︎

Modèles de document

Vous pouvez paramétrer à l'avance des modèles de documents.

1. Ouvrir un dossier "Modèle" ou "Template"

2. Y créer autant de notes que de modèles
3. Pour chaque note-modèle : faire une structure. Exemple ici avec une note IMRAD

Modèle IMRAD

Introduction
Revue
Méthode
Résultats
Discussion
Conclusion
Références

4. Dans les paramètres, cliquer sur "Modèles" et préciser le nom du dossier dans lequel
vous avez déposé vos modèles.
 5. Créer une nouvelle note où vous le souhaitez. Quand vous êtes sur la note, cliquez sur
l'icône des deux feuilles dans la barre latérale de gauche

La liste des modèles existants s'ouvre.

Choisissez le modèle choisi. Votre nouvelle note apparaîtra avec la structure du modèle :

Lier les notes

Liens bidirectionnels
La spécificité de Obsidian est qu'il fait du lien sa mission première et notamment de ce qu'on
appelle les liens bidirectionnels.

Lien unidirectionnel = lien hypertexte. Je sais vers où je pointe, mais je ne peux pas partir
d'un point pour voir et consulter toutes les pages qui pointent vers lui.
Lien bidirectionnel = double lien : je peux voir depuis où je pars et depuis où j'arrive.
 Rétrolien = lien qui permet de voir les notes qui pointent vers telle ou telle note.

Est-ce qu'il existe d'autres outils de prise de note qui proposent des liens bidirectionnels ?
Oui

Org Roam
Roam Research
RemNote
Notions
etc.

Comment faire des liens entre notes ?

Solution 1 : les tags !

Ajouter des tags, avec un # et pas d'espace derrière.

#méthodo

Dès que vous tapez #, s'ouvre une fenêtre avec les tags que vous avez déjà créés dans ce
coffre.

Si vous cliquez sur un tag d'une page, la fenêtre de gauche vous affiche toutes les
occurrences de ce tag.

#markdown

Solution 2 : les liens bidirectionnels/rétroliens

Ouvrir des doubles crochets : [[]]

[[]]

Dès que vous tapez [[]], s'ouvre une fenêtre avec les notes que vous avez déjà créées dans ce
coffre. Cela sert à lier des notes entre elles !

[[]]
Une fois choisi, la note liée s'affiche ainsi :
Hospitalité
Vous pouvez cliquer sur le lien pour accéder à la note. Le lien n'est consultable qu'à
condition d'avoir la note et d'être sur Obsidian.

En mode "reading view" / "lecture" vous pouvez consulter dans une fenêtre pop-up la page
vers laquelle vous avez mis un lien.*
 C'est génial pour relier deux notions abordées par un auteur ou pour scinder deux
documents et ne pas les rendre trop lourds.

Tag et du lien ont des couleurs différentes :

Hospitalité
#hospitalité

Note dans la note

Il est possible d'intégrer une note dans une note au moyen des liens.
Méthode : ! + [[]] et choix de la note à mettre.

La note va s'ouvrir dans un cadre : voir l'exemple pour la note Markdown insérée plus haut.

Faire des renvois plus précis

Lier une note à une partie spécifique d'une autre note.

Texte + faire un lien [[]], choisir sa note, puis ajouter un # à la fin du titre de la note pour
trouver le titre choisi.
Exemple : Je renvoie ma note vers la note Hospitalité, et je peux choisir la partie de cette
note vers laquelle renvoyer.

Si vous ajoutez le point d'interrogation, alors cette partie de la note liée et seulement celle-ci
s'affichera dans votre note.

Si vous ajoutez à votre lien un accent circonflexe :

[[ Hospitalité^
une fenêtre s'ouvre et vous pouvez choisir de lier un texte précis de votre note liée.

Avec le !, vous pouvez l'afficher dans votre note.

 à l’heure où la crise migratoire révèle, une fois encore, l’impuissance des nations
européennes face au tragique de l’Histoire, il paraît nécessaire et urgent de poser les
bases d’une hospitalité citoyenne. Car il n’y a pas de citoyenneté sans relation de
proximité et pas de relation de proximité sans hospitalité.
-\ Albanel, V. (2016). Pour une hospitalité citoyenne. Études, , 41-50.
[Link] paragraphe 32.

Note : Obsidian donne un numéro à cette ancre dans le texte. Il le fait automatiquement.

Exemple :
J'envoie vers URFIST/Informatique/Markdown 1/Markdown > ^055738 qui renvoie vers le
texte où je dis que je vous fais une démo en direct. Si j'écris un

en direct je vous fais une démo nette et précise

Vous pouvez aussi mettre des alias, pour avoir des liens plus lisibles : ajouter avant de fermer
les doubles-crochets un | et écrire l'alias. voir : [Link]
v=v6GnfarL1vM&ab_channel=CerveauNum%C3%A9riqueFr

A propos des liens sur Obsidian : [Link]

La vue graphique
Avec les lien bidirectionnels, on peut donc aller d'une note à une autre, mais comment savoir
quels retroliens partent ou arrivent sur une page ?

Grâce à la vue graphique !

Exemple vue graphique d'une collègue

La vue graphique de mon Obsidian :

Avec des détails :

Notes :

On peut afficher la vue graphique de sa note en cours en vertical ou horizontal

On peut aussi retrouver la vue graphique complète via la barre d'outil à droite.
On peut se promener d'un point à l'autre et ouvrir les notes de lecture.
On peut voir l'historique des liens faits entre toutes les notes. Pour cela, dans la vue
graphique, cliquer sur la baguette magique :

Je ne l'utilise pas au quotidien, mais quand je travaille sur un concept, je regarde

toujours si je l'ai lié à d'autres notes et en général j'essaye de me rappeler
pourquoi, ce qui m'oblige à me replonger dans le système général de ma pensée
et à me détacher de la prise de note trop spécifique à un texte.
Make it super extensible
Ce qui vous permet d'étendre votre Obsidian, c'est les Plugins.

Plugins

Pour ajouter des plugins :

télécharger puis installer

ou dans paramètres : faire une recherche à partir de l'onglet Plugins complémentaires.

Et toujours la fenêtre de commande pour mettre en œuvre certains plugins : CTRL + P

Mindmap
Vous pouvez faire une sortie Mind map de votre note de lecture. Pour cela, il vous faut un
plugin, comme MindMap NextGen.

En suivant CTRL + P, vous pouvez générer une mindmap de votre note.

Je n'ai pas d'usage des mindmap, mais pour les fans, ça peut vous servir.
Vous pouvez même mettre votre mindmap dans une fenêtre horizontale ou verticale et la
consulter en même temps que vous rédigez.

Faire une table des matières sur Obsidian

Plugin : automatic Table of Content

CTRL P : automatic table of content

Obsidian ?
 Qu'est-ce que c'est ?
Zettelkasten
A quoi ça sert ?
Pourquoi je l'utilise plutôt qu'un autre outil ?
Obsidian
Qui le propose ?
Obsidian spécificités
Coût
Installation
Apparence
Organisation
Structure
Coffre / Vault
Dossiers
Note
Canva
Apparence :
Les thèmes
Fenêtres
Rédiger des notes
Ecrire
Markdown
Ecrire en Markdown
Modèles de document
Lier les notes
Liens bidirectionnels
Comment faire des liens entre notes ?
Solution 1 : les tags !
Solution 2 : les liens bidirectionnels/rétroliens
Note dans la note
Faire des renvois plus précis
La vue graphique
Make it super extensible
Mindmap
Faire une table des matières sur Obsidian
Zotero
Exporter son document
En PDF
Pandoc
 Présentation/slides
Conclusion
Merci

Dans le bloc ajouter les options souhaitées. Par exemple :

style: number
min_depth: 1
max_depth: 6

Zotero
==Etape 1 : ==
Avoir une bibliothèque Zotero !

==Etape 2 : ==
Exporter sa bibliothèque Zotero en better bib teX ou better CSL JSON

==Etape 3 : ==
Télécharger le plugin Zotero
Attention, il se charge pour chaque coffre

J'ai téléchargé le plugin suivant :

CITATION

==Etape 4 : ==
Paramétrer l'affichage de la citation
Aller dans paramètres > citations > Litterature Note Content Template.

Pour afficher la référence sous le texte choisi, mettre dans Litterature Note Content Template
:

REF : {{authorString}}, ({{year}}), {{title}}, {{containerTitle}}, {{publisher}}, p.{{page}}.

doi{{DOI}},
-- {{zoteroSelectURI}}

ça s'affichera de la manière suivante :

REF : Anne H. Toomey, (2023), Why facts don't change minds: Insights from cognitive science
for the improved communication of conservation research, Biological Conservation, , p.109886.
doi10.1016/[Link].2022.109886,
-- zotero://select/items/@toomeyWhyFactsDon2023

Pour afficher une note de bas de page, mettre dans Litterature Note Content Template :

{{citekey}}
^{{citekey}}: {{authorString}}, ({{year}}), {{title}}, {{containerTitle}}, {{publisher}}, p.{{page}}.
doi{{DOI}},
Etape 5 : citer
Depuis une note de lecture, sélectionnez CTRL + P. Taper "citation"

Cela va ouvrir votre liste bibliographique :

Choix 1 : Insert Literature Note Link : génère automatiquement un rétrolien/lien

bidirectionnel vers une nouvelle note de lecture. Celle-ci porte le nom de la clé de citation
Zotero de la référence.

Attention à bien préciser dans paramètres le nom du dossier dans lequel vous voulez mettre
vos fiches de lecture.
Choix 2 : Insert littérature note content in the current pane : insère le contenu d'une
référence dans le corps de votre note de lecture.

Cela va s'afficher comme vous l'avez paramétré. Voir ci-dessus.

Remarques
A mon avis, ces citations ne sont pas du tout aussi propres et complètes que quand je cite
depuis Zettlr, LateX ou même Word. Je n'ai pas ma notice complète, notamment parce que je
ne sais pas paramétrer les styles.

Il est possible de lier une note Obsidian à une note de lecture ou une annotation sur un PDF
dans Zotero. Donc, cela peut-être très précis, mais pour ma part, je n'annote pas les PDF sur
Zotero et je n'ai donc jamais utilisé ce système de citation.

Exporter son document

En PDF
On peut exporter en PDF.

CTRL P : Exporter en PDF

Ou cliquer sur les trois petits ronds : Exporter en PDF

Pandoc
Cependant, on peut avoir besoin d'exporter de manière plus fine. Il est alors possible
d'installer un plugin Pandoc.

Plugin Pandoc pour Obsidian : [Link]

Pour ouvrir Pandoc : ouvrir la boite de commande : CTRL + P et taper Pandoc.

Pandoc

Pandoc est un convertisseur de document.

Pandoc User's Guide : très très très complet.
[Link]

Avant Pandoc : si je créé un PDF avec latex

Comment fonctionne la compilation :

J'ouvre la Boite de commande, que je choisis mon dossier et que j'écris

pdflatex (espace) nom de mon [Link] : ça me sort un PDF de mon lateX. Il ajoute aussi
tous les fichiers connexes.

Il va falloir cependant lui indiquer qu'il y a un fichier biblio, parce que sinon il sort le pdf
sans le fichier bibliographique, sans les références.
Pour ajouter la biblio, taper en ligne de commande :
bibtex (espace) nom du fichier (sans l'extension). Il va ajouter de nouveaux fichiers dans
mon dossier.

Et enfin, il faut relancer pdflatex pour que ça marche complètement. Et parfois le refaire
une quatrième fois quand on compile le doc pour la première fois.

Avec Pandoc
Il est possible de faire avec des pousse-boutons, mais ce sera mieux en boite de
commande.

Pandoc User's Guide : très très très complet.

[Link]

Pour convertir un document .md

1. dans la boite de commande ouvrir le dossier où est le doc

2. pandoc (espace)
3. nom du doc
4. ajouter les spécifications souhaitées, les arguments
Exemple :
pandoc-f = FROM : pour lui expliquer que le doc est en md ou autre
pandoc-t = TO : pour lui dire en quel format on veut le document
pandoc-o = OUTPUT : nom du fichier exporté

PDF
pandoc [Link] -f markdown -t pdf -o [Link]

Attention, pour pouvoir bien convertir en PDF il faut avoir un bonne installation LateX.

Word
pandoc [Link] -f markdown -t docx -o [Link]

HTML
Si on tape :

pandoc [Link] -f markdown -t html -o [Link]

On aura un document incomplet. Pour export html besoin de préciser aussi l'argument -s
= STANDALONE : pour obtenir un document complet.
Pas besoin de faire ça pour les autres formats.

pandoc -s [Link] -f markdown -t html -o [Link]

Standalone : va vraiment lire les métadonnées.

Sans standalone :

Avec Standalone

Pour ajouter des options

Par exemple : mettre des titres numérotés, ajouter une table des matières, etc.

solution 1 : métadonnées
Mettre les options dans le doc lui-même
Dans le bloc de métadonnnées : Yaml

Voir dans le manuel, dans la section "Default Files" la liste des options qu'on peut mettre
dans le bloc de métadonnées Yaml.

Exemple d'options :
subtitle: nom
lang: fr
abstract:

URFIST/Informatique/Markdown 1/YAML

solution 2 : code pandoc

mettre les options dans la commande pandoc

Voir dans le manuel, dans la section "General writer options" la liste des options qu'on
peut mettre dans la commande.

Exemple avec l'ajout d'une table des matières

pandoc -s [Link] -f markdown -t html -o [Link] --toc

“images/Pasted image [Link]” ne peut être trouvé.

-N = pour numéroter les sections du doc

--toc = pour ajouter une table des matières
--toc-depth=N = pour dire la profondeur de la table des matières.

...

pandoc [Link] -o [Link] -N --toc --toc-depth=2

Pour la biblio :

--citeproc = pour lui dire de citer les références

--bibliography=Nom de la [Link] = pour lui dire où aller chercher les références : fichier
bibtex. A noter qu'on peut mettre l'adresse du fichier s'il n'est pas dans le même dossier.
--csl=[Link] = pour lui dire le style de citation
--css=[Link] = pour lui préciser le style
La différence entre les deux derniers ne sont pas clairs pour moi
 Equation complète :

pandoc [Link] -o [Link] -N --toc --toc-depth=2 --citeproc --bibliography=Nom

de la [Link] --csl=[Link] --css=[Link]

solution 3 : fichier de défaut

Faire un fichier de configuration par défaut de pandoc. On écrit toutes les spécifications
Yaml dans un doc, qui sera utilisé pour nos exports.

fichier de défaut = feuille de style

Voir dans le manuel, dans la section "Default Files" la liste des options qu'on peut mettre
dans la feuille de style.

Dans la commande, il faudra lui dire d'aller appliquer le "default file" paramêtré.

1. Créer un [Link]
2. Y mettre toutes mes options
3. exécuter la commande pandoc : pandoc...... -o [Link] -d [Link]

Créer une feuille de style .yml : URFIST/Informatique/Markdown 1/YAML > Yaml Default
files

Quarto

Présentation/slides
A noter qu'il y a la possibilité d'afficher son document en mode Présentation.

Suivre les ... verticaux et choisir "Démarrer la présentation"

ou
Fenêtre de commande : CTRL + P > Diapositives : démarrer la présentation.

*** : changement de diapo

Conclusion
J'adore cet outil !!!!!!!!!
Lancez-vous, dans celui-ci ou dans un autre, mais lancez-vous !
Pour info, comme il existe une diversité de méthodes de prise de note, un petit partage
d'une doctorante américaine qui utilise Obsidian et fait des tutos :
[Link]
v=vFW0nP3XjQA&list=PLi5PzoXlqDUpft99c7pQvxX_S6GTC2W2a

Merci
Contact : Raphaëlle Bats
[Link]@[Link]

MàJ : mars 2025