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

• 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