Why did org mode invent a new markup syntax instead of just going with markdown?

This page summarizes the projects mentioned and recommended in the original post on /r/emacs

Our great sponsors
  • InfluxDB - Power Real-Time Data Analytics at Scale
  • WorkOS - The modern identity platform for B2B SaaS
  • SaaSHub - Software Alternatives and Reviews
  • commonmark-spec

    CommonMark spec, with reference implementations in C and JavaScript

  • Talking about the downsides of Markdown: it's not that you can't use Markdown without tables. Since there is not just one Markdown flavor, there are variants such as this one which do define table support and more. This introduces other difficulties to users of Markdown. For example, you need to know what kind of Markdown is supported with your current tool-set. In my business life, we do use a tool-chain to generate documents via Markdown, pandoc and pp (I'm not sure if the correct link is this or that). Using that, I may use even two different kinds of Markdown tables with different syntax and different features for formatting. I guess I don't need to explain much more on that to emphasize that this is a complicated thing to write and maintain since editing tools do not seem to support Markdown tables at all or they only support only one kind of Markdown table and not all of them. It's a big mess that the original authors or Markdown could not foresee and later, nobody could fix it so far although there is CommonMark which tried to fix it but it didn't stick much.

  • github-orgmode-tests

    This is a test project where you can explore how github interprets Org-mode files

  • For example this https://github.com/commonmark/commonmark-spec/wiki/markdown-flavors and for org is only one standard documented on https://orgmode.org/

  • InfluxDB

    Power Real-Time Data Analytics at Scale. Get real-time insights from all types of time series data with InfluxDB. Ingest, query, and analyze billions of data points in real-time with unbounded cardinality.

    InfluxDB logo
  • vim-orgmode

    Text outlining and task management for Vim based on Emacs' Org-Mode

  • Recently vim got a new package which try to implement org-mode https://github.com/jceb/vim-orgmode.

  • org-mode

  • Here is the source code for org-md-export https://gitlab.com/akater/org-mode/-/blob/org-element-cleaner-parsers/lisp/ox-md.el. It's not too long as far as transformation code goes (~750 loc), but also not the most trivial. Of note are the parts that require larger functions (and therefore more logic) which seem to be the parts relating to org's cross-linking structure (links, headlines and headline references, as well as list items). I would love for them to be unified, but I'm guessing there may be surprising difficulties, and I'm guessing the necessary, incompatible changes would be too much to stomach for so many long-time users.

  • obsidian-releases

    Community plugins list, theme list, and releases of Obsidian.

  • That sounds cool. But again it seems like these are features of a tool rather than the core syntax that are giving you the benefits. Have you looked at obsidian? I'm not suggesting it's better or worse, but that the markdown syntax itself is kinda the side issue, compared to the tool features.

  • orgdown

  • pandoc

    Universal markup converter

  • Talking about the downsides of Markdown: it's not that you can't use Markdown without tables. Since there is not just one Markdown flavor, there are variants such as this one which do define table support and more. This introduces other difficulties to users of Markdown. For example, you need to know what kind of Markdown is supported with your current tool-set. In my business life, we do use a tool-chain to generate documents via Markdown, pandoc and pp (I'm not sure if the correct link is this or that). Using that, I may use even two different kinds of Markdown tables with different syntax and different features for formatting. I guess I don't need to explain much more on that to emphasize that this is a complicated thing to write and maintain since editing tools do not seem to support Markdown tables at all or they only support only one kind of Markdown table and not all of them. It's a big mess that the original authors or Markdown could not foresee and later, nobody could fix it so far although there is CommonMark which tried to fix it but it didn't stick much.

  • WorkOS

    The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.

    WorkOS logo
  • pp

    PP - Generic preprocessor (with pandoc in mind) - macros, literate programming, diagrams, scripts... (by CDSoft)

  • Talking about the downsides of Markdown: it's not that you can't use Markdown without tables. Since there is not just one Markdown flavor, there are variants such as this one which do define table support and more. This introduces other difficulties to users of Markdown. For example, you need to know what kind of Markdown is supported with your current tool-set. In my business life, we do use a tool-chain to generate documents via Markdown, pandoc and pp (I'm not sure if the correct link is this or that). Using that, I may use even two different kinds of Markdown tables with different syntax and different features for formatting. I guess I don't need to explain much more on that to emphasize that this is a complicated thing to write and maintain since editing tools do not seem to support Markdown tables at all or they only support only one kind of Markdown table and not all of them. It's a big mess that the original authors or Markdown could not foresee and later, nobody could fix it so far although there is CommonMark which tried to fix it but it didn't stick much.

  • pp

    preprocessor (by njamescouk)

  • Talking about the downsides of Markdown: it's not that you can't use Markdown without tables. Since there is not just one Markdown flavor, there are variants such as this one which do define table support and more. This introduces other difficulties to users of Markdown. For example, you need to know what kind of Markdown is supported with your current tool-set. In my business life, we do use a tool-chain to generate documents via Markdown, pandoc and pp (I'm not sure if the correct link is this or that). Using that, I may use even two different kinds of Markdown tables with different syntax and different features for formatting. I guess I don't need to explain much more on that to emphasize that this is a complicated thing to write and maintain since editing tools do not seem to support Markdown tables at all or they only support only one kind of Markdown table and not all of them. It's a big mess that the original authors or Markdown could not foresee and later, nobody could fix it so far although there is CommonMark which tried to fix it but it didn't stick much.

NOTE: The number of mentions on this list indicates mentions on common posts plus user suggested alternatives. Hence, a higher number means a more popular project.

Suggest a related project

Related posts