Это реализуемо с помощью ярлыка ссылки (link label), с которым не связывается ни одна ссылка.
Эти ярлыки ссылок будут вырезаны при экспорте:
(пустая строка)
[comment]: # (comment text)
(пустая строка)
[//]: # (comment text)
Сравните с обычным синтаксисом ссылки:
[link text][label]
[label]: http://ru.stackoverflow.com/questions/ask
В принципе, спецификация Markdown допускает вариант, когда перед комментарием нет пустой строки, а вместо #
используется <>
. Проблема в том, что спецификация дырява как решето, а имеющиеся 28+ реализаций работают по–разному. Добро пожаловать в Markdown!
Проверить работу различных реализаций нам поможет инструментарий Babelmark2, проверяющий рендеринг разметки Markdown в различных реализациях. (+
— прошли тест, -
— не прошли, ?
— оставляют неотображаемый мусор в HTML).
Согласно проверке, наиболее платформо-независимый вариант — это #
и пустая строка перед комментарием. Пустая строка после комментария не играет роли. В частности, набирающая популярность строгая спецификация CommonMark, в разработке которой участвует Jeff Atwood, работает именно с этим вариантом (и не работает с <>
и/или без пустой строки)
C этими реализациями нет никакой возможности использовать такие комментарии:
- cebe/markdown 1.1.0
- cebe/markdown MarkdownExtra 1.1.0
- cebe/markdown GFM 1.1.0
- s9e\TextFormatter (Fatdown/PHP)
Исследование основано на решении, предложенном участником Magnus на SO.EN.