[syntax] 마크 다운의 코멘트

이전에 제안 된 모든 솔루션 (특정 구현이 필요한 솔루션 제외)은 주석이 표시되지 않더라도 출력 HTML에 주석이 포함된다고 생각합니다.

자신에게만 맞는 주석을 원할 경우 (변환 된 문서를 읽는 사람이 “소스보기”로도 볼 수 없어야 함) 링크 레이블 (참조 스타일 링크와 함께 사용)을 사용할 수 있습니다. 핵심 마크 다운 사양에서 사용 가능 :

http://daringfireball.net/projects/markdown/syntax#link

그건:

[comment]: <> (This is a comment, it will not be included)
[comment]: <> (in  the output file unless you use it in)
[comment]: <> (a reference style link.)

아니면 더 나아갈 수도 있습니다.

[//]: <> (This is also a comment.)

플랫폼 호환성을 개선하고 하나의 키 입력을 저장하기 위해 다음 #대신 (합법적 인 하이퍼 링크 대상) 을 사용할 수도 있습니다 <>.

[//]: # (This may be the most platform independent comment)

이식성을 최대화하려면이 유형의 주석 전후에 빈 줄을 삽입해야합니다. 정의가 일반 텍스트에 대해 브러시 될 때 일부 마크 다운 구문 분석기가 올바르게 작동하지 않기 때문입니다. Babelmark에 대한 가장 최근의 연구에 따르면 전후의 빈 줄이 모두 중요합니다. 빈 줄이없는 경우 일부 파서는 주석을 출력하고, 빈 줄이없는 경우 일부 파서는 다음 줄을 제외합니다.

일반적으로이 접근법은 핵심 사양의 일부이므로 대부분의 Markdown 파서에서 작동합니다. (여러 링크가 정의되거나 링크가 정의되었지만 사용되지 않은 경우의 동작이 엄격하게 지정되지 않은 경우에도)

답변

<!---
your comment goes here
and here
-->

(empty line)
[comment]: # (This actually is the most platform independent comment)

{% comment %}
    These commments will not include inside the source.
{% endcomment %}

[](Comment text goes here)

<a href="Comment%20text%20goes%20here"></a>

<!---
First comment line...
//
_NO_BLANK_LINES_ARE_ALLOWED_
//
_and_try_to_avoid_double_minuses_like_this_: --
//
last comment line.
-->