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

Sevalla - Deploy and host your apps and databases, now with $50 credit!
Sevalla is the PaaS you have been looking for! Advanced deployment pipelines, usage-based pricing, preview apps, templates, human support by developers, and much more!
sevalla.com
featured
InfluxDB – Built for High-Performance Time Series Workloads
InfluxDB 3 OSS is now GA. Transform, enrich, and act on time series data directly in the database. Automate critical tasks and eliminate the need to move data externally. Download now.
www.influxdata.com
featured
  1. 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.

  2. Sevalla

    Deploy and host your apps and databases, now with $50 credit! Sevalla is the PaaS you have been looking for! Advanced deployment pipelines, usage-based pricing, preview apps, templates, human support by developers, and much more!

    Sevalla logo
  3. 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/

  4. 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.

  5. 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.

  6. 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.

  7. orgdown

  8. 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.

  9. InfluxDB

    InfluxDB – Built for High-Performance Time Series Workloads. InfluxDB 3 OSS is now GA. Transform, enrich, and act on time series data directly in the database. Automate critical tasks and eliminate the need to move data externally. Download now.

    InfluxDB logo
  10. pp

    Discontinued 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.

  11. 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

  • How to Automate Document Workflows for Developers

    1 project | dev.to | 23 Apr 2025
  • How I'm Automating `resume.pdf` creation with Git Hooks and Pandoc

    1 project | dev.to | 1 Jan 2025
  • NOTE: How to Install LaTeX and Pandoc on Ubuntu

    1 project | dev.to | 5 Dec 2024
  • Ask HN: Why aren't more books offered as Markdown?

    1 project | news.ycombinator.com | 3 Jul 2024
  • LaTeX makes me so angry at word

    1 project | news.ycombinator.com | 26 Mar 2024