3 ms·

No one has mentioned metadata. Yes, Org Mode is a kitchen sink, for better or worse, but at least I can make annotations, even some structured data. Markdown

No one has mentioned metadata. Yes, Org Mode is a kitchen sink, for better or worse, but at least I can make annotations, even some structured data. Markdown doesn't even have comments. I won't criticize Markdown (or anything) for failing to achieve what it doesn't attempt, but as a programmer I consider any format with fixed semantics to be, as Bret Victor might say, "dead fish." I know XML has a bad rap (for good reasons), but at least they were trying to be extensible!

ChrisSD 9y ago
As far as I understand it, Markdown is a superset of HTML (with some caveats). So Markdown does have comments, they're the same as HTML comments. From https://daringfireball.net/projects/markdown/syntax https://daringfireball.net/projects/markdown/syntax > For any markup that is not covered by Markdown’s syntax, you simply use HTML itself. There’s no need to preface it or delimit it to indicate that you’re switching from Markdown to HTML; you just use the tags. > The only restrictions are that block-level HTML elements — e.g. <div>, <table>, <pre>, <p>, etc. — must be separated from surrounding content by blank lines, and the start and end tags of the block should not be indented with tabs or spaces. Markdown is smart enough not to add extra (unwanted) <p> tags around HTML block-level tags.
- klibertp 9y ago
  No, it's still an HTML comment - it will be present in the output generated from Markdown. If it was Markdown comment, it wouldn't show up in the output.
  - WorldMaker 9y ago
    If that is a feature or a bug depends on perspective and if a Markdown renderer strips HTML comments or not is an option for many of them. (That said, I do miss the reStructuredText comments sometimes in Markdown, but partly because the syntax was so simple.)
c-cube 9y ago
As a programmer, I consider a format that is deeply tied to one particular editor as "don't touch it with a 10 foot pole". Org-mode without emacs isn't particularly attractive (I prefer markdown or asciidoc when it comes to syntax; tooling and popularity are limited). And I have no plan of learning emacs or elisp(!). In a way, org-mode is the .doc of markup languages.

ChrisSD 9y ago

As far as I understand it, Markdown is a superset of HTML (with some caveats). So Markdown does have comments, they're the same as HTML comments. From https://daringfireball.net/projects/markdown/syntax https://daringfireball.net/projects/markdown/syntax > For any markup that is not covered by Markdown’s syntax, you simply use HTML itself. There’s no need to preface it or delimit it to indicate that you’re switching from Markdown to HTML; you just use the tags. > The only restrictions are that block-level HTML elements — e.g. <div>, <table>, <pre>, <p>, etc. — must be separated from surrounding content by blank lines, and the start and end tags of the block should not be indented with tabs or spaces. Markdown is smart enough not to add extra (unwanted) <p> tags around HTML block-level tags.

klibertp 9y ago
No, it's still an HTML comment - it will be present in the output generated from Markdown. If it was Markdown comment, it wouldn't show up in the output.
- WorldMaker 9y ago
  If that is a feature or a bug depends on perspective and if a Markdown renderer strips HTML comments or not is an option for many of them. (That said, I do miss the reStructuredText comments sometimes in Markdown, but partly because the syntax was so simple.)

c-cube 9y ago

As a programmer, I consider a format that is deeply tied to one particular editor as "don't touch it with a 10 foot pole". Org-mode without emacs isn't particularly attractive (I prefer markdown or asciidoc when it comes to syntax; tooling and popularity are limited). And I have no plan of learning emacs or elisp(!). In a way, org-mode is the .doc of markup languages.