Unless such functionality has been added without my realising it, then
no, the only way of having comments in Markdown is HTML comments.
Why do you find HTML comment syntax problematic? Because the
comments pass through to HTML, or because you don't like typing
the <!-- -->?
The former, and because there have been a few times I'd like to have
been able to get at them when using pandoc as a library without having
to match on the contents of RawHtml.
> Because I have to avoid "--" inside of the HTML comment, as I recently
> learned the hard way. I don't know whether there are gotchas I've not
> yet encountered.
Same here, HTML comments can't suit my use-case of using emacs Org table mode to edit
markdown tables. Also, I sometime want to keep my source document privatly, and only share
it's HTML or PDF output. Comments, in this case, are for the author (me) only.
The proposal was that a certain subset of HTML comments (those that
begin with |) would not get passed through to the generated HTML.
So that's a non-issue. The issue about HTML comment syntax is
different, but to tell the truth, pandoc's HTML parser just starts
with <!-- and ends with -->; it doesn't implement the official
HTML comment syntax, which hardly anyone knows anyway.
> The proposal was that a certain subset of HTML comments (those that
> begin with |) would not get passed through to the generated HTML.
> So that's a non-issue.
Sure, this proposal seems very good for the use cases raised.
> The issue about HTML comment syntax is
> different, but to tell the truth, pandoc's HTML parser just starts
> with<!-- and ends with -->; it doesn't implement the official
> HTML comment syntax, which hardly anyone knows anyway.
The problem is that if you use double dashes in markdown, the comment will go straight to
the html output, and will produce strange rendering in browsers that are aware of the spec
(firefox, for one). In my exemple, parts of my emacs org tables would appear, broken, in
I've written a Perl script which restores template syntax
which has been hidden from pandoc/markdown/HTML Tidy
inside HTML comments with certain embellishments, and
completely removes HTML comments with certain other
embellishments. Just pipe pandoc/HTML Tidy output
The documentation is some 140 lines and the script is
some 30 lines...
I don't know if this list accepts attachments, but I'll
give it a try...