

The most recent research with Babelmark shows that blank lines before and after are both important.

To improve platform compatibility (and to save one keystroke) it is also possible to use # (which is a legitimate hyperlink target) instead of : : # (This may be the most platform independent comment)įor maximum portability it is important to insert a blank line before and after this type of comments, because some Markdown parsers do not work correctly when definitions brush up against regular text. Or you could go further: : (This is also a comment.) : (in the output file unless you use it in) That is: : (This is a comment, it will not be included) If you want a comment that is strictly for yourself (readers of the converted document should not be able to see it, even with "view source") you could (ab)use the link labels (for use with reference style links) that are available in the core Markdown specification: Visit the Features page for more details.I believe that all the previously proposed solutions (apart from those that require specific implementations) result in the comments being included in the output HTML, even if they are not displayed. Syntax highlighting in fenced code blocks.Highly customisable Markdown rendering.MacDown is heavily influenced by Mou, and I try to mimic much of its behaviour as much as possible both in UI and the logic underneath, only making changes when I feel that improvement is necessary. So I started from scratch, spent some weekends hacking together my own solution. I don’t have nearly enough money to match Chen Luo’s purposed offer, but I do have my own pocket of tricks and some free time. No suitable offers surfaced (I honestly do not think there will be, either), and I decided that instead of waiting for others to do something about this, I should act myself. It came as a great shock when Chen Luo announced that he felt he could not actively continue the development, and wished to sell the ownership of Mou. I write Markdown all the time, and since I use macOS on a daily basis, Mou is my go-to editor whenever I wish to generate something with markup.
