Skip to content

Keszako, le JsoMD ?

Contexte

Ça fait un moment, que je me dis qu'il faut que je prenne le temps d'apprendre Typst, c'est vrai que c'est un peu la hype autour du machin. J'ai un peu joué avec et puis je me suis arrêté en me disant :

Ce machin faut prendre le temps de bien comprendre, c'est moins trivial que ça en a l'air...

Bon ce week-end étant entre deux projets, je me suis dit alors on s'y met ! Me voilà donc lancé dans la doc, regarder des tutos et puis commencer à jouer avec mes documents !

Obsidian

Un logiciel pas « open source » mais gratuit qui est mon meilleur ami, en voilà un scandale. Bon c'est pas grave quoi qu'il arrive mes données sont en MarkDown alors 0 risque.

Pensées émues aux derniers utilisateurs de Publisher ! Et je repense à Piège dans le cyberespace de Roberto Di Cosmo, 1998, il me semble qu'on avait été prévenu !

Revenons donc à Obsidian, je vais pas parler ici de Zettelkasten parce que je ne parle pas d'un truc dont je n'arrive pas à prononcer le nom. Je suis très très graphe et réseau sémantique comme garçon, ce qui dans le passé m'a plongé dans une longue histoire d'amour avec la ZODB de Plone.

Mais on est pas là pour parler de mes amours d’antan, mais de ceux présents ...

MarkDown

Séduisant comme un high kick à la glotte, le MarkDown est devenu mon format de travail, source de vérité unique et d'échange.

  • Article de blog
  • Note de projet
  • Note de documentation
  • Document Driven avec les fences

Cas d'usage avec le projet Tortuga

Tortuga, c'est mon ploteur de LSystem en python, si le sujet vous intéresse voir le site d'Alexendre Villares , il est une source d'inspiration pour moi depuis plus de 10 ans.

Le script Tortuga consomme donc en entrée une fiche MarkDown structurée de la manière suivante :

---
type: lsystem
title: villares1
uuid: 6f718b4b-c512-46ab-b8b0-399edc7a5fbc
---
# Villares1

Arbre proposé par Alexandre Villares [https://github.com/villares/sketch-a-day/tree/main/2026/sketch_2026_09_25](https://github.com/villares/sketch-a-day/tree/main/2026/sketch_2026_09_25)


## Tirage
Avec la palette de couleur [[Impluse1]]

``jsonl
C#!2
R#!3
``

[Tirage](1e07952ecafa4556.png)

## Configurations
``json
 { 
   "grammaire": 
   { 
     "axiom": "Y",
     "rules": {
       "X": "[-FY][+FY]FY",
       "Y": "YF[+XFB][-XFB]X",
       "F": "[-F+FA]FF"
   },  
   "iterations":7,
   "angle":45
 }
``

La fiche porte les commentaires, la donnée et présente le résultat.

Ici deux types de données

  • la palette de couleur dans un fence jsonl

  • la configuration de l'arbre LSystem dans un fence json

C'est pas le sujet mais ça donne ça à la fin après les post-traitements sous Gmic

Le JsoMD & Typst

En lisant la documentation de Typst, la section Data Loading, on apprend que le langage gère nativement :

  • cborReads structured data from a CBOR file.
  • csvReads structured data from a CSV file.
  • jsonReads structured data from a JSON file.
  • readReads plain text or data from a file.
  • tomlReads structured data from a TOML file.
  • xmlReads structured data from an XML file.
  • yamlReads structured data from a YAML file.

et c'est à Json que ça a fait tilte !

Pourquoi ?!

Parce qu'en général dans mes projets de RAG ou d'ETL, j'ai tendance à sanctuariser mes données dans un « pivot JSON » et lorsque je dis sanctuariser, je parle IPFS mais c'est un autre sujet.

Prenons l'exemple de mon projet d'analyse de l'offre de formation en France, les données XML LHEO de France Compétence sur le RNCP et RS, finissent dans un « pivot JSON » qui est ensuite injecté dans la vectorisation pour le RAG.

Mais Typst a un problème !

Enfin me pose un problème, aussi fort que tu sois et malgré le fait que tu sois 100 fois plus séduisant que Latex, ce qui n'est pas un exploit non plus, vu de qui on parle. C'est pas pour autant que je vais faire de la double saisie ou même tenter du parsing avec Pandoc, je tiens à ma santé mentale !

Imaginons donc l'article suivant lagravite.md

# La gravite

## Introduction à la gravité

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean lacinia, nulla nec dignissim fermentum, dolor purus malesuada justo, ut blandit velit tellus et felis. Maecenas eget neque vitae mi facilisis porta non sodales sem. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Maecenas dictum purus condimentum est rutrum, quis condimentum arcu volutpat. Fusce ut aliquet augue, nec mollis enim. Curabitur ex enim, eleifend et condimentum eget, faucibus vel nunc.

## Approche avancée : courbure de l'espace-temps et limites quantiques

Suspendisse in egestas odio. Pellentesque feugiat, nibh nec porta iaculis, leo velit interdum justo, quis eleifend quam metus ac neque. Vivamus ipsum mi, volutpat vitae risus quis, ultricies lacinia dui. Morbi eget auctor nisl. Vivamus tempus sapien id arcu sagittis viverra. Praesent nec massa ut metus commodo vestibulum. Sed et hendrerit odio. Integer a nisl posuere, ultricies eros in, dictum nulla. Donec dictum justo urna, quis fermentum libero pellentesque non. Integer fringilla fermentum sem id cursus. In tempus felis sapien, vitae finibus elit scelerisque eget. Nullam volutpat tortor id nisi ornare egestas. In dapibus egestas nibh vitae consectetur. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.

## Sources

* **Newton, I.** (1687). *Philosophiæ Naturalis Principia Mathematica*. Londres : Royal Society. (Formalisation de la mécanique classique et de la loi universelle de la gravitation).
* **Einstein, A.** (1915). *Die Feldgleichungen der Gravitation* (Les équations du champ de la gravitation). Sitzungsberichte der Preussischen Akademie der Wissenschaften zu Berlin, pp. 844–847.

Et un parser python qui grâce à Mistletoe dumpe lagravite.md en .lagravite.jsomd

{
  "meta": {
    "source": "la_gravite.md"
  },
  "tree": {
    "1": {
      "title": "La gravité",
      "sections": {
       "1.1": "## Introduction à la gravité\n\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Aenean lacinia, nulla nec dignissim fermentum, dolor purus malesuada justo, ut blandit velit tellus et felis. Maecenas eget neque vitae mi facilisis porta non sodales sem. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Maecenas dictum purus condimentum est rutrum, quis condimentum arcu volutpat. Fusce ut aliquet augue, nec mollis enim. Curabitur ex enim, eleifend et condimentum eget, faucibus vel nunc.",
        "1.2": "## Approche avancée : courbure de l'espace-temps et limites quantiques\n\nSuspendisse in egestas odio. Pellentesque feugiat, nibh nec porta iaculis, leo velit interdum justo, quis eleifend quam metus ac neque. Vivamus ipsum mi, volutpat vitae risus quis, ultricies lacinia dui. Morbi eget auctor nisl. Vivamus tempus sapien id arcu sagittis viverra. Praesent nec massa ut metus commodo vestibulum. Sed et hendrerit odio. Integer a nisl posuere, ultricies eros in, dictum nulla. Donec dictum justo urna, quis fermentum libero pellentesque non. Integer fringilla fermentum sem id cursus. In tempus felis sapien, vitae finibus elit scelerisque eget. Nullam volutpat tortor id nisi ornare egestas. In dapibus egestas nibh vitae consectetur. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.",
        "1.3": "## Sources\n\n* **Newton, I.** (1687). *Philosophiæ Naturalis Principia Mathematica*. Londres : Royal Society. (Formalisation de la mécanique classique et de la loi universelle de la gravitation).\n* **Einstein, A.** (1915). *Die Feldgleichungen der Gravitation* (Les équations du champ de la gravitation). Sitzungsberichte der Preussischen Akademie der Wissenschaften zu Berlin, pp. 844–847."
      }
    }
  }
}

et maintenant un template Typst avec la fonction render-jsomd

#import "@preview/cmarker:0.1.2"

#let render-jsomd(path) = {
  let data = json(path)
  for (h1_key, h1_node) in data.tree {
    if h1_node.title != "" { heading(level: 1, h1_node.title)  }
    for sec_key in h1_node.sections.keys().sorted() {
      let md = h1_node.sections.at(sec_key)
      if md != "" {    cmarker.render( md,scope: (image: (path, alt: none) => image(path, alt: alt)) )  }
    }
  }
}

#set document(title: "Article")
#set page(
  paper: "a4",
  margin: (x: 2.5cm, y: 2.5cm)
)

#set text(font: "DejaVu Serif", size: 10.5pt, lang: "fr")
#set par(justify: true, leading: 0.7em)
#render-jsomd("contenu/.la_gravite.jsomd")

Résultat !

Bilan du Poc

Bien que l'exemple soit crasseusement simpliste, la démonstration est faîte que le dump d'un fichier MarkDown en un clone Json, le JsoMD rend l'accès au contenu quasiment trivial dans un template Typst.

Donc je peux continuer d'écrire dans Obsidian en Markdown et piloter la production sans plus d'effort de PDF avec des templates Typst.

Est ce si simple que ça ?

Un - Règle stricte d'écriture

J'ai arrêté une règle de structuration assez stricte pour mes articles, j'indexe les titres de niveau 1 et 2.

  • 1 Chapitre

  • 2 Section

  • 3 Illustration/Data

De toute façon, cette règle est lié à mes habitudes d'écriture, mon discours est souvent porté par une TOC de niveau 1 et 2

Deux - C'est un langage programmation

J'ai galéré avec les images et sans les forums et les moteurs de recherche, j'aurai pas trouvé la solution. Typst doit ne doit pas être abordé comme du templating à la Jinja mais comme un langage de programmation !

Trois - Pas sorti du sable

Je redoute des galères avec Typst dont je ne dois même pas avoir conscience. Mais ce sont les joies de l'apprentissage d'un nouveau langage , les bugs ...

On tombe dessus, c'est le jeu ma pauvre Lucette !