Aller au contenu

Multimédia

Liens

Liens internes

Inscrire la syntaxe [[nom_du_fichier]] dans une note, permet de lier de façon bidirectionnelle celle-ci à un autre fichier du coffre.
C’est une spécificité d’Obsidian et des logiciels de son genre qui permet la navigation entre les notes et leurs pièces jointes contenues dans le dossier d’Obsidian.

Compléments
  • La syntaxe [[nom_du_fichier|alias]] utilise l’alias choisit à la place du nom du fichier comme texte de support du lien ;
  • La syntaxe [[nom_du_fichier#un titre|alias]] pointe vers un titre en particulier dans la note ;
  • La syntaxe [[nom_du_fichier^|alias]] pointe vers un bloc en particulier dans la note ;

Ces liens sont mis en évidence par la Vue graphique et sont aussi utilisés dans les modules principaux Rétrolien et Liens sortants.

Autres avantages des liens bidirectionnels
  • Lorsque l’on modifie le nom du fichier dans le lien, Obsidian renomme automatiquement le fichier dans l’explorateur et inversement.
  • Si l’on déplace le fichier lié dans l’arborescence des dossiers du coffre, Obsidian met à jour automatiquement le chemin relatif du lien.

Liens externes

Le plus simple pour intégrer un lien hypertexte est de coller son adresse directement dans le MarkDown, par exemple le code http://obsidian.md produit http://obsidian.md ;
De cette façon on peut aussi indiquer une adresse mail, par exemple le code prenom.nom@ecmorlaix.fr produit prenom.nom@ecmorlaix.fr.

La syntaxe [texte](URL "info-bulle") lie une adresse web à un texte support avec l’affichage optionnel d’une info-bulle au survol du lien, par exemple le code [Cf. documentation obsidian : Liens](https://help.obsidian.md/How+to/Format+your+notes#Links "Aide officielle sur les liens") produit Cf. documentation obsidian : Liens ;

Comment alléger le code MarkDown de ses trop longues URL ?

Parce que de longues adresses de liens dégradent la lisibilité du texte en mode édition de code, MarkDown permet de définir des liens par référence.
Dans ce cas, on définit tous les liens à un endroit du document, en dehors du texte (généralement rassemblé), avec la syntaxe :

[référence]: URL "infobulle"

et au fil du texte on lie cette adresse par sa référence à un texte support avec la syntaxe [texte][référence] ou encore tout simplement [référence].
Cette solution offre aussi l’avantage de pouvoir partager la même adresse par plusieurs liens en ne la définissant qu’une fois dans le document.
Exemple :
Le code MarkDown du paragraphe d’introduction comporte de nombreux liens de ce type, tous listés à la fin du texte…

Mettre l’URL entre deux chevrons <URL> si elle contient des espaces…

Images

Cf. documentation obsidian : Images

La syntaxe pour afficher des images dans une note est la même que celle pour les liens,  mais avec un ! devant.

Images du web

Pour insérer l’affichage d’une image disponible sur le web on utilise le code MarkDown générique d’un lien externe, avec un ! devant :

![texte alternatif](adresse "infobulle")

  • L’infobulle optionnelle s’affichera au survol de l’image.
  • Il est important de bien choisir le texte alternatif qui s’affichera lorsque l’image n’est pas disponible, car il permet aussi l’accessibilité pour les non-voyants et apporte de la sémantique pour les moteurs de recherche…
  • L’adresse est l’URL absolue qui permet d’atteindre le fichier lié sur le web, ou le chemin relatif vers un fichier
Exemple

Le code MarkDown ![Logo du site https://compresspng.com](https://compresspng.com/images/compresspng/logo.svg "Compresser vos images avec la force d'un éléphant !"), affiche :

Logo du site https://compresspng.com

Cette syntaxe fonctionne aussi avec une image du coffre…

Le code MarkDown ![Logo du site https://compresspng.com](assets/compress_png.svg "Compresser vos images avec la force d'un éléphant !"), affiche la même chose :

Logo du site https://compresspng.com
Remarque :
La mise à jour automatique du lien relatif peut poser problème en cas de changement de dossier…

Images du coffre

Pour insérer l’affichage d’une image disponible dans le coffre d’Obsidian, il peut-être plus pratique d’utiliser le code MarkDown spécifique d’un lien interne, avec un ! devant :

![[nom_fichier_image]]

Le plus simple pour obtenir ce code est alors de glisser/déposer un fichier image depuis l’explorateur dans le code MarkDown d’une note là ou l’on souhaite insérer l’image

Exemple

Le code MarkDown ![compress_png.svg](<assets/compress_png.svg>), affiche :

compress_png.svg

A venir…

En ligne ou en bloc

taille des images

Image support de lien

Alignement
https://github.com/SlRvb/Obsidian--ITS-Theme#image-positions

Quel format d’image pour le web ?
  • JPEG  (Joint Photographic Expert Group)
    Parfait pour les photos et visuels colorés, c’est le format compressé le plus utilisé sur le web.
  • PNG (Portable Network Graphics)
    Idéal pour les images à fond transparent, graphique et logo.
  • SVG (Graphics Interchange Format)
    Format adapté aux images vectorielles, permet de les déformer sans altérer la qualité.
  • GIF (Graphics Interchange Format)
    Images animées idéale pour illustrer vos propos, fortement utilisé sur les réseaux sociaux.
Réduire le poids des images

D’une manière générale, il est important pour accélérer le processus d’affichage et limiter l’impact environnementale produit par nos documents (transfert, stockage) de réduire la taille des fichiers intégrées et particulièrement celle des images.
On gagne toujours en choisissant bien le format adaptés à l’utilisation finale du document :

  • une image vectorielle (.svg) offre généralement plus de qualité qu’une image matricielle pour du dessin ;
  • une image matricielle (.png dessin, .jpeg photo, .gif animation) destinée à l’affichage n’a pas besoin d’autant de définition que pour une impression.

De plus on peut très avantageusement les compresser :

12,3ko en .svg compress_png.svg à comparer en zoomant avec
14,0ko en .png compress_png.png .

Cette dernière après une compression réglée sur 3 couleurs, réduit son poids de 85% ce qui donne seulement 2,1ko en .png qui suffisent ici à faire le job : compress_png-min.png compress_jpeg-min.png compress_gif-min.png
Après avoir Glisser/Déposer le fichier original, en cliquant sur la vignette du fichier réduit proposé au téléchargement, on accède à des réglages supplémentaires qui permettent d’accentuer encore la compression obtenue par défaut. Le volet horizontal montre alors la différence obtenu à l’affichage… il y a forcément des pertes, mais tant que l’information à transmettre reste visible et correcte, le jeu en vaut la chandelle car l’économie peut être très significative

A venir…

Tableau

\(\LaTeX{}\)

Cf. documentation obsidian : Math

\(\LaTeX\), qu’on prononce “LaTèque”, est un langage de description à balisage dédié à l’édition et la publication de rapports scientifiques avec une typographie irréprochable.  

Dans une note.md d’Obsidian, il est possible d’intégrer des instructions codées en \(\LaTeX\) qui seront interprétées par la librairie JavaScript Mathjax embarquée pour afficher des équations et autres symboles scientifiques.

Principe

Pour une formule en ligne, au fil du texte, telle que \(f(x) = x^2\), il faut encadrer l’expression entre deux simples $...$ comme ceci $f(x) = x^2$.

Pour une formule en bloc, dans un nouveau paragraphe centré, il faut encadrer l’expression entre deux doubles $$...$$ comme cela :

$$
F(x) = \int^a_b \frac{1}{2}x^4
$$

ce qui produit :

\[ F(x) = \int^a_b \frac{1}{2}x^4 \]

Exemples

Code Résultat Code Résultat
$x + y$ \(x + y\) $x - y$ \(x - y\)
$x \times y$ \(x \times y\) $x \div y$ \(x \div y\)
$x^2$ \(x^2\) $y^{(x-1)}$ \(y^{(x-1)}\)
$\pi \approx 3.14159$ \(\pi \approx 3.14159\) $1 \neq 2$ \(1 \neq 2\)
$0 < 1$ \(0 < 1\) $2 > 1$ \(2 > 1\)
$x \leq 2$ \(x \leq 2\) $x \geq 1$ \(x \geq 1\)
${3 \over 4}$ \({3 \over 4}\) $\dfrac{1}{2x}$ \(\dfrac{1}{2x}\)
$U_n = 3 \times U_{n-1}+2$ \(U_n = 3 \times U_{n-1}+2\) $f(x) = \sqrt[3]{2x} + \sqrt{x-2}$ \(f(x) = \sqrt[3]{2x} + \sqrt{x-2}\)
Code Résultat
Boole $a\oplus b=\bar{a}\cdot b+a\cdot\bar{b}$ \(a\oplus b=\bar{a}\cdot b+a\cdot\bar{b}\)
Force $\overrightarrow{F_{(ext \to S)}}$ \(\overrightarrow{F_{(ext \to S)}}\)
Moment $\sum\overrightarrow{M_G(\overrightarrow{F_{(ext \to S)}})}$ \(\sum\overrightarrow{\mathscr M_G(\overrightarrow{F_{(ext \to S)}})}\)
Unité $\|\overrightarrow{C_\text{moteur}}\|=49,52\;\mathrm{N\!\cdot\!m}$ \(\|\overrightarrow{C_\text{moteur}}\|=49,52\;\mathrm{N\!\cdot\!m}\)
Nom Code Lettre Code Lettre Code Lettre
alpha $\alpha$ \(\alpha\) $A$ \(A\)
beta $\beta$ \(\beta\) $B$ \(B\)
gamma $\gamma$ \(\gamma\) $\Gamma$ \(\Gamma\)
delta $\delta$ \(\delta\) $\Delta$ \(\Delta\)
epsilon $\epsilon$ \(\epsilon\) $E$ \(E\) $\varepsilon$ \(\varepsilon\)
zeta $\zeta$ \(\zeta\) $Z$ \(Z\)
eta $\eta$ \(\eta\) $H$ \(H\)
theta $\theta$ \(\theta\) $\Theta$ \(\Theta\) $\vartheta$ \(\vartheta\)
iota $\iota$ \(\iota\) $I$ \(I\)
kappa $\kappa$ \(\kappa\) $K$ \(K\) $\varkappa$ \(\varkappa\)
lambda $\lambda$ \(\lambda\) $\Lambda$ \(\Lambda\)
mu $\mu$ \(\mu\) $M$ \(M\)
nu $\nu$ \(\nu\) $N$ \(N\)
xi $\xi$ \(\xi\) $Xi$ \(Xi\)
omicron $\omicron$ \(\omicron\) $O$ \(O\)
pi $\pi$ \(\pi\) $\Pi$ \(\Pi\) $\varpi$ \(\varpi\)
rho $\rho$ \(\rho\) $P$ \(P\) $\varrho$ \(\varrho\)
sigma $\sigma$ \(\sigma\) $\Sigma$ \(\Sigma\) $\varsigma$ \(\varsigma\)
tau $\tau$ \(\tau\) $T$ \(T\)
upsilon $\upsilon$ \(\upsilon\) $\Upsilon$ \(\Upsilon\)
phi $\phi$ \(\phi\) $\Phi$ \(\Phi\) $\varphi$ \(\varphi\)
chi $\chi$ \(\chi\) $X$ \(X\)
psi $\psi$ \(\psi\) $\Psi$ \(\Psi\)
omega $\omega$ \(\omega\) $\Omega$ \(\Omega\)

Ressources

Diagrammes avec Mermaid

Cf. documentation obsidian : Diagrammes

Obsidian utilise la bibliothèque JavaScript Mermaid.js pour générer l’affichage de diagrammes à partir des instructions d’un bloc de code spécifique.

Par exemple :

```mermaid
graph TD;
    A((A)) --- B((B));
    A --- C((C));
    B --- D((D));
    B --- E( );
    D --- F((F));
    D --- G((G));
    C --- H( );
    C --- I((I));
    linkStyle 3 stroke-width:0px;
    linkStyle 6 stroke-width:0px;
    style E opacity:0;
    style H opacity:0;
```

Produit l’arbre :

graph TD; A((A)) --- B((B)); A --- C((C)); B --- D((D)); B --- E( ); D --- F((F)); D --- G((G)); C --- H( ); C --- I((I)); linkStyle 3 stroke-width:0px; linkStyle 6 stroke-width:0px; style E opacity:0; style H opacity:0;

De nombreux autres types de graphique sont possibles et il existe un éditeur en ligne
assez pratique…

Intégrations

iFrame

Cf. documentation obsidian : Embedding

Par exemple, le code HTML :

<iframe src="https://ericecmorlaix.github.io/Toto.html?embed=true" width="800" height="780" frameborder="0" allowfullscreen="allowfullscreen"></iframe>

permet l’intégration de la page web telle que :

qui est un contenu interactif H5P généré avec l’app.lumi.education

Notes

![[test]]

Toto est dans la place !

Audio

Vidéos

Pdf

En résumé

Inspiré du guide obsidian de Johackim

Syntaxe Markdown

Obsidian utilise la syntaxe Markdown par défaut :

  • [Link Text](URL "infobulle") : Créer un lien avec URL + infobulle
  • ![Alt Text](URL "infobulle") : Créer une image + infobulle
  • [ref1] et [ref1]: <url> "infobulle" : Créer une référence + infobulle
  • [Link Text][ref1] et [ref1]: <url> "infobulle" : Créer une référence avec un texte personnalisé + infobulle

Syntaxe d’Obsidian

Mais il a quelques spécificités de syntaxes supplémentaires :

  • [[Linking Note]] : Créer un lien vers une autre note
  • [[Linking Note|Link Name]] : Créer un lien avec un nom personnalisé
  • [[Linking Note#heading]] : Créer un lien vers un titre d’une note
  • ![[Linking Note^]] : Intégrer un bloc d’une note
  • ![[Filename]] : Intégrer une autre note
  • ![250](https://johackim.com/soon?title=250 "Note bientôt disponible") : Insérer une image embed de 250px de largeur

  • ![|250](https://site.xyz/image.png) : Insérer une image de 250px de largeur

  • #tag : Créer un tag

  • #nested/tag : Créer un sous-tag

  • aliases: [Alias1, Alias2] : Créer un alias (à ajouter dans le frontmatter)


Dernière mise à jour: September 12, 2023