La syntaxe d’Org Mode est l’un des langages de balisage les plus rationnels pour le texte (2017)

 (karl-voit.at)
3 points par GN⁺ 2026-01-12 | 1 commentaires | Partager sur WhatsApp
  • La syntaxe d’Org Mode est présentée comme un langage de balisage léger intuitif et cohérent utilisable aussi en dehors d’Emacs
  • Sa grammaire de base — titres, listes, mise en forme, liens — repose sur une structure simple et facile à mémoriser, avec une plus grande cohérence d’expression que d’autres langages
  • Contrairement aux nombreuses variantes dérivées de Markdown, Org Mode conserve une forme relativement standardisée autour d’une implémentation unique (Emacs Org-mode)
  • La conversion est possible avec divers outils comme Pandoc, et l’écriture reste facile dans un éditeur de texte classique, même sans utiliser Emacs
  • Parmi les langages de balisage léger, il se distingue par sa lisibilité, sa maintenabilité et la qualité de son outillage, et est mis en avant comme une alternative à la rédaction de documents en texte brut

Aperçu de la syntaxe d’Org Mode

  • La syntaxe d’Org Mode ne dépend pas d’Emacs et peut être utilisée dans vim, Atom, Notepad, etc.
    • Les titres expriment la hiérarchie avec *, **, ** *
    • La mise en forme du texte suit les formes *bold*, /italic/, _underlined_, +strikethrough+, =monospaced=
    • Les liens restent simples avec la syntaxe [[URL][description]]
    • Les listes (-, 1.), cases à cocher ([ ], [X]), blocs de code (#+BEGIN_SRC ... #+END_SRC), etc. sont également pris en charge
  • Les tableaux peuvent être difficiles à aligner manuellement, mais la syntaxe reste reconnue même sans alignement
  • L’utilisateur peut apprendre naturellement la syntaxe sans fiche mémo particulière

Standardisation et problèmes de Markdown

  • Markdown souffre de nombreux standards dérivés (Original, Extra, MultiMarkdown, GitHub Flavored, CommonMark, etc.), ce qui entraîne des problèmes de compatibilité
    • Même quand il est appelé « Markdown », la syntaxe varie selon les outils, provoquant pertes de données et baisse d’utilisabilité
  • Org Mode définit toute sa syntaxe à partir d’une seule implémentation, Emacs Org-mode, ce qui permet une interprétation cohérente
    • Les outils dérivés fonctionnent sous forme de sous-ensemble (subset) de l’original
    • L’extension de fichier est toujours normalisée en .org
  • Il n’existe pas de document de standard officiel, mais l’implémentation Emacs joue de fait le rôle de standard de référence

Comparaison de cohérence et d’utilisabilité

  • Syntaxe des titres : Org Mode exprime simplement la hiérarchie avec le seul préfixe *
    • Markdown, AsciiDoc, reStructuredText, etc. utilisent des structures complexes et incohérentes, avec préfixes, suffixes ou soulignements
    • Certains langages autorisent des styles mixtes, ce qui accentue la confusion
  • Syntaxe des liens : [[URL][texte]] d’Org Mode est simple, alors que
    • [texte](URL) en Markdown ou `texte <URL>`_ en reStructuredText reposent sur des combinaisons de symboles plus complexes et moins cohérentes
  • Syntaxe de mise en forme : Org Mode utilise /italic/, *bold*, ~monospace~, +strikethrough+, avec une structure cohérente en paires de symboles
    • Markdown emploie _italic_, **bold**, ~~strike~~, etc., avec un nombre de symboles et des règles irréguliers

Facilité de saisie et indépendance vis-à-vis des outils

  • Org Mode demande peu de caractères inutiles et n’impose ni alignement manuel ni syntaxe complexe
  • Même en dehors d’Emacs, un texte rédigé en syntaxe Org Mode peut être converti en HTML, PDF, Word et d’autres formats via Pandoc
  • GitHub et GitLab peuvent aussi rendre les fichiers Org, ce qui reste efficace même dans un environnement d’édition texte simple
  • Il est souligné que plus l’environnement manque de support outillé, plus la syntaxe d’Org Mode devient utile

Support outillé dans Emacs

  • Dans Emacs, la rédaction en Org Mode permet de manipuler la structure avec TAB, Alt+flèche, Ctrl+Return, etc.
    • Prise en charge automatisée du pliage/dépliage des titres, du déplacement des listes, du déplacement des lignes et colonnes de tableaux, etc.
  • Une approche par menus est également possible, et il reste possible d’écrire efficacement sans apprendre de raccourcis clavier
  • L’usage d’Emacs n’est pas obligatoire, mais il offre, lorsqu’on l’utilise, l’expérience d’édition de balisage la plus puissante
  • Markdown, AsciiDoc, reStructuredText, etc. ne disposent pas d’un niveau de support outillé comparable

Conclusion et proposition d’Orgdown

  • L’objectif des langages de balisage léger est la concision et l’efficacité, et Org Mode présente à cet égard la conception la plus rationnelle
  • Markdown, AsciiDoc, reStructuredText, etc. souffrent d’une cohérence insuffisante et d’une syntaxe complexe, ce qui réduit leur utilisabilité
  • Org Mode offre une courbe d’apprentissage faible, une indépendance vis-à-vis des outils et une forte compatibilité de conversion
  • Depuis 2021, cette réflexion a évolué vers une nouvelle tentative de standardisation appelée Orgdown
    • Présentée comme un projet indépendant de standardisation d’un balisage léger fondé sur la syntaxe d’Org Mode

Discussion complémentaire et retours

  • Certains utilisateurs ont souligné l’absence de standard officiel pour Org Mode
    • Il existe des différences d’interprétation entre Emacs et Pandoc, mais l’implémentation Emacs est malgré tout considérée comme la référence de fait
  • Des retours ont également porté sur la fonctionnalité de références de liens de reStructuredText, mais
    • l’auteur continue d’estimer qu’Org Mode est le langage de balisage léger le plus logique et le plus facile à mémoriser
  • En conclusion, Org Mode est présenté comme une alternative rationnelle à la rédaction de documents en texte brut, au-delà du seul écosystème Emacs

À lire aussi

1 commentaires

 
GN⁺ 2026-01-12
Commentaires Hacker News
  • J’ai commencé à utiliser Emacs en 2016, quand j’ai quitté Evernote pour org-mode
    Aujourd’hui, j’utilise org-mode pour tous mes projets, mes tâches et ma gestion des connaissances. Certains fichiers dépassent les 15 Mo
    Au début, je n’utilisais que les en-têtes, puis à chaque fois que j’avais un besoin, la fonctionnalité existait déjà. Je trouve qu’il est rare d’avoir un outil à la fois facile à utiliser et doté d’une puissante extensibilité
    • Je me demande comment vous gérez le texte enrichi comme les PDF, les images ou le HTML. Evernote gère très bien ça, et c’est ce qui m’empêche encore de partir
    • Moi aussi j’utilise org-mode depuis quelques années, mais seulement pour les en-têtes de base, le formatage, les liens et les blocs de code
      S’il y a des fonctionnalités avancées qui valent le coup d’être apprises, je veux bien des recommandations
    • 15 Mo, ça doit faire dans les 3 millions de mots. C’est presque l’équivalent de 60 romans, c’est impressionnant
  • Le format org est intuitif en lui-même, mais sa vraie force vient de son intégration avec Emacs
    On peut l’utiliser pour la gestion de l’information personnelle (PIM), la rédaction de documents, les notes, les raccourcis automatisés, etc.
    Plutôt qu’un simple format de remplacement pour Markdown, il révèle tout son potentiel dans l’écosystème Emacs
    • Je pense que le format org gagnerait encore en valeur s’il était adopté aussi largement que Markdown en dehors d’Emacs
      Le billet de Karl Voit soutient que la syntaxe org est plus cohérente et plus concise que Markdown
      Dans le monde de la technique, le meilleur format ne gagne pas toujours, mais ça vaut quand même la peine de continuer à le défendre
    • J’utilise aussi Markdown tous les jours, mais en pratique je trouve orgdown plus utile
      Ce billet lié insistait aussi sur ce point
  • J’écris tous mes livres en Markdown
    Avant j’utilisais du XML, mais c’était trop pénible, donc j’ai changé. Je génère du HTML et du PDF avec un workflow basé sur Pandoc
    Récemment, j’utilise Typst pour produire les PDF plus rapidement.
    J’ai créé le projet xml2typ, qui génère des PDF bien plus vite que Pandoc/LaTeX
    • On peut générer un PDF directement avec Typst, donc je me demande s’il y a une raison particulière de passer par docbook et xsltproc
    • J’ai regardé le dépôt, ce serait bien d’inclure aussi le rendu PDF final de test.md
  • Cela fait longtemps que je propose org comme format d’échange entre outils de productivité
    org peut unifier les bookmarks, le PKM et la gestion des tâches
    Mais à l’ère de l’IA, Markdown devient le format par défaut pour l’entraînement des LLM
    Cela dit, les LLM gèrent aussi très bien org, donc il y a de la place pour une coexistence des deux
    Voir aussi cette proposition liée
    • Le point central de mon texte, c’est la syntaxe d’org-mode (orgdown). Les outils comme Sharepoint ou Jira, c’est un autre sujet
    • Je continue à penser que ConnectedText restait meilleur pour la recherche et la robustesse qu’org
      C’est dommage qu’il ne soit pas passé en open source. Ça montre bien la limite des projets maintenus par une seule personne, le SPOF
    • D’après mon expérience, les LLM gèrent eux aussi très bien org-mode. Il y a suffisamment de données org sur Internet pour l’entraînement
  • Cela fait 10 ans que j’organise ma vie avec org-mode
    Grâce à Beorg sur iOS, je l’utilise aussi très bien sur mobile
    org-ql et org-super-agenda m’ont fait gagner en productivité
    Je tiens chaque jour un journal de travail dans des fichiers org, et ça m’aide énormément au moment des bilans annuels
    • Je recommande mon extension de navigateur BrainTool
      Elle synchronise les bookmarks et les onglets avec des fichiers org pour les gérer comme des TODO
    • Je réfléchis aussi à la structure d’un journal. Je préfère des titres centrés sur le contexte plutôt que sur la date
      Je me demande comment vous organisez les liens entre fichiers. J’envisage aussi denote
  • J’ai l’impression qu’exprimer du HTML ou du LaTeX complexes en org-mode est au contraire plus difficile
    Donc pour les cas compliqués, j’écris directement le HTML ou le LaTeX source
    Le programme org-mode lui-même est excellent, mais si on regarde uniquement la syntaxe, Markdown est plus pratique
    En migrant mon blog d’org vers Markdown, mon code est devenu plus concis et c’était 50 fois plus rapide
    • À l’inverse, moi je suis passé de Markdown à org
      J’ai créé le projet shite, un générateur de site en Bash, et j’insère directement des blocs HTML dans org
      La fonction org-edit-special, qui permet d’éditer uniquement le HTML, était très utile
    • Avec des blocs de code (#+BEGIN_SRC html), on peut aussi avoir la coloration syntaxique par langage
      C’est pratique avec des raccourcis yasnippet
    • Dans org, on peut insérer facilement du HTML/LaTeX
      J’écris tous mes documents Beamer en org depuis 2009
      J’ai aussi ajouté la prise en charge d’org à mon blog Pelican via un plugin Python
    • Moi aussi j’ai migré mon blog d’org vers Markdown
      org est une idée élégante, mais son manque de compatibilité pose problème. Markdown est pris en charge partout, donc c’est le choix le plus réaliste
  • Markdown est déjà devenu le standard du balisage léger
    Même si org-mode est plus rationnel, en pratique il est plus réaliste d’utiliser Markdown comme choix par défaut vu sa popularité
    • Il faut voir Markdown comme un nom, et Org-mode comme un verbe (un système)
      Ce n’est pas juste une comparaison de formats, ce sont des outils avec des modes de fonctionnement complètement différents
      Markdown n’apporte que de la structure, alors qu’Org inclut de l’état et de la logique d’exécution
      Donc le débat sur le « choix par défaut » n’a pas vraiment de sens. Chacun peut utiliser ce qui correspond à son besoin
    • Est-ce qu’on devrait vraiment choisir un format de fichier personnel en fonction de sa popularité ?
      Il n’y a aucune raison de dire à quelqu’un qui utilise org-mode d’arrêter
    • Au final, c’est une question de préférence. Comme LaTeX vs Typst, il faut choisir l’environnement qui vous convient
    • Je trouve que Markdown est plus agréable à lire en texte brut
      Les en-têtes avec astérisques d’org sont visuellement plus chargés. En revanche, j’aime bien la notation de l’italique
    • Markdown a beaucoup de problèmes d’ambiguïté et de compatibilité
      Chaque implémentation diffère, et des fonctions comme les tableaux ou les notes de bas de page existent à part sous forme d’extensions
      Son seul vrai avantage, c’est son universalité
  • J’ai récemment commencé à utiliser gemtext (.gmi) de Gemini à la place de Markdown
    Il a moins de fonctionnalités, mais il est simple et facile à parser. Les liens commencent par =>, et la séparation des paragraphes est claire
    Mon parseur fait environ 70 lignes et couvre 95 % des besoins que je couvrais avec Markdown
    • J’aime bien gemtext moi aussi. Des en-têtes simples et des liens suffisent largement
      En revanche, je trouve gênant que les retours à la ligne servent à séparer les paragraphes.
      Comme dans Pandoc Markdown, utiliser des doubles sauts de ligne pour les paragraphes serait mieux
  • Le plus grand atout d’org-mode, c’est sa fonction de macros
    J’écris des supports de cours en ligne en org-mode, puis je les exporte en HTML chaque semestre
    J’automatise l’expansion de texte, l’évaluation d’elisp, etc. avec des macros
    Par exemple, {{{NOUN-C}}} devient « Clause » ou « Rule » selon le contexte
    La date en haut de page est aussi générée automatiquement en elisp.
    J’utilise l’hébergement site44.com, synchronisé avec Dropbox, donc il suffit d’enregistrer pour que ce soit publié sur le web
  • org-mode n’a toujours pas de spécification officielle (spec)
    C’est pour cela que presque aucun autre outil ne le prend en charge. En face, CommonMark est standardisé
    Je vais donc continuer à utiliser CommonMark
    • L’absence de spec n’est pas forcément ce qui freine org. Markdown aussi a réussi grâce à sa simplicité et son intégration
      Le fait que des sites comme Reddit aient adopté Markdown était même plutôt un bon choix
    • Le document org-syntax joue un peu le rôle d’une spécification non officielle
    • Python n’a pas non plus de spec, mais CPython fait office de standard de fait. C’est une situation comparable
    • Il existe beaucoup d’applications qui prennent en charge org. Applications mobiles, plugins Vim, GitHub, Codeberg, etc. le prennent aussi en charge
      Il y a plus de solutions open source solides pour la synchronisation locale qu’avec Markdown
      Les applications de notes basées sur Markdown sont au contraire plus dépendantes du cloud
    • Codeberg prend aussi en charge org dans les README. D’autres forges Git le prennent aussi partiellement en charge