AsciiDoc

vs Markdown

마크다운의 장점은 단순함 이다.
덕분에 많은 사람들이 이용하게 되었고,
플러그인과 툴 같은 서드파티 지원도 빵빵하기 때문에 다른 마크업 언어들과의 격차가 많이 벌어진 상태다.
이 블로그 에서도 마크다운을 주로 사용해왔다.

단순한 건 좋지만 가끔씩 기능이 부족한 게 느껴질 때가 많다.
예를 들어, 비디오 임베딩 기능이 없다. 표준 마크다운 문법을 사용한다면, 그저 썸네일 이미지로 링크를 걸 수 있을 뿐이다.

markdown:
[](https://youtu.be/uLR1RNqJ1Mw?t=0s) Video Label

asciidoc:
video::2dgGhi7MFqo[youtube, width=800, height=450, opts=autoplay]

유튜브 영상 id를 이용

또 한 예로, Table of Contents 를 만들 때도 마크다운은 서드파티 라이브러리 혹은 플러그인의 도움을 빌려야한다. 하지만 아스키독에서는 기본 문법으로 지원한다.

마크다운을 사용하면서 이런 기능들을 보완하려면 다른 추가 문법을 사용하거나 툴의 도움을 빌려야 하는데
강력한 표준 없이 이렇게 Flavor 가 자꾸 생겨나는 것은 결국 확장성을 떨어뜨리고 마크다운의 단순함마저 해치게 될 것이다.

결국 강력하고도 단순한 마크업 언어가 필요하다.

참고 : 기술 문서에 마크다운을 쓰지 말 것

Asciidoc

문법

마크다운에 비하면 요소들이 많다는 게 러닝 커브를 가파르게 하지만, 테이블 문법이나 링크 문법 같은 경우는 오히려 쉬운 것 같기도 하다.

https://asciidoctor.org/docs/asciidoc-syntax-quick-reference/
https://powerman.name/doc/asciidoc
https://narusas.github.io/2018/03/21/Asciidoc-basic.html (한국어)

Asciidoctor

기존 asciidoc 은 파이썬 2로 만들어졌지만 루비 구현인 Asciidoctor를 많이 쓴다.

자바스크립트 구현인 asciidoctor.js 까지 나와있다.

asciidoctor

asciidoctor.js

사용법

asciidoctor sample.adoc