경량 마크업 언어 adoc (Asciidoc)

https://asciidoctor.org/

 

.adoc이라는 확장자로 사용되는 Asciidoc문서는 MD(markdown)과 비슷한 문서 작성을 위한 경량 마크업 언어입니다. 어느정도 대중화 되어 사용되는 MD에 비해 아직 많이 사용되고 있지는 않지만 Spring Rest Docs(https://spring.io/projects/spring-restdocs)등이 asciidoc를 이용하여 작성되었습니다. MD에서 제공하는것과 유사한 문서 작성을 위한 문법 뿐만 아니라 다른 adoc문서를 연결하는 link기능등 확장된 기능을 제공하고 있습니다.

문서 자체는 .adoc 확장자의 text문서에 불과하고, Asciidoctor(https://asciidoctor.org/) 를 이용해 html이나 pdf등으로 변환하여 활용할 수 있습니다.

인텔리J 플러그인(https://plugins.jetbrains.com/plugin/7391-asciidoc) 이나 VSCode 익스텐션(https://marketplace.visualstudio.com/items?itemName=joaompinto.asciidoctor-vscode) 등도 제공되고 있어 손쉽게 사용 해 볼 수 있습니다.

Asciidoc 사용법에 대한 내용은 사용 매뉴얼(http://asciidoc.org/userguide.html)에서 확인할 수 있습니다. 기본 문법에 대해 한글로 번역(https://narusas.github.io/2018/03/21/Asciidoc-basic.html) 포스팅도 참고 하면 좋겠네요.