Qiita의 기사 작성이나, GitHub의 README등에서도 널리 채용되고 있는 Markdown입니다만, 그 표기법이 사이트나 소프트에 의해 약간 다릅니다.

John Gruber가 고안한 Markdown 원래 Markdown 표기법의 텍스트 파일을 Perl로 작성된 parser를 통해 HTML을 생성한다는 표기법과 parser가 세트가 된 것이었습니다. 그 후, 그 편리성으로부터 Perl 이외의 parser도 개발되어 게다가 Pandoc 과 같이 HTML 뿐만 아니라 EPUB 형식 등 복수의 형식에 출력할 수 있는 것이 등장했습니다. 그리고 동시에 새로운 확장 기능과 그 확장 기능을 이용하기 위한 표기법이 추가되어 결과적으로 소프트 별 표기법에 차이가 생기게 되었습니다. 이 표기법(및 그 표기법으로 실현하는 기능)의 차이를, flavor, syntax extension, 방언, 등이라고 불리는 것입니다.

Markdown 커뮤니티 하지만 Markdown parser 목록 를 공개하고 있습니다만, 이 일람은 어디까지나 parser의 일람이며, 그 외에도 Pandoc의 Markdown 를 베이스로 한, 문서중의 R 코드의 실행을 상정했다 R Markdown remark 을 베이스로 JSX도 쓸 수 있도록 했다 MDX 등이 등장하고 있어 Markdown은 지금도 다양화하고 있습니다.

그러나 각각의 parser에서 Markdown의 표기법이 전혀 다르다는 것은 아니고, 사용 빈도가 높은 것은 일부 통일되어 있기도 합니다. 예를 들어 3개의 백틱( ``` )으로 둘러싸여 코드 블록을 표현하는 작업은 오리지널 Markdown에서는 지원되지 않지만 지금은 Markdown 표기법의 디펙트 표준이 되고 있다고 말할 수 있을 것입니다.

그러나 표기법이 동일하더라도 생성되는 HTML은 parser에 따라 다릅니다. parser 당 HTML의 차이는 babelmark 라는 사이트에서 볼 수 있습니다.

이러한 상황을 받아 표기법의 표준화를 목표로 하는 CommonMark이 2014년에 등장했습니다. 2019년에는 버전 0.29이 공개되어 앞으로도 업데이트될 예정입니다. Markdown이 문서를 관리할 계획이라면 동향을 주시해야 할 것입니다.

(개인적으로는 Python-Markdown 에서 채용되고 있다 Admonition 기능이 꽤 마음에 들고 있습니다만, remark-admonitions 그럼 표기법이 다르거나 하기 때문에 통일되지 않을까 기대하고 있습니다.)

비고

이 문서는 크리에이티브 커먼즈 디스플레이 4.0 국제 라이센스에서 제공됩니다.