개요

프로젝트 문서 작성이 필요한 경우 text 로 관리할 수 있는 markdown 형식을 권장하지만 markdown 은 표현력이 부족한 단점이 있습니다.


ascii doc 은 markdown 에 비해 표현력이 풍부하지만 사용자가 많지 않고 별도의 문법을 배워야 하는 단점이 있습니다.

eclipse 를 사용할 경우 ascii doctor plugin 이 제공되므로 문법에 익숙하지 않아도 사용할 수 있는 장점이 있습니다.


사용


  1. File  메뉴에서 New  → File  을 선택합니다.
  2. ascii doc 파일명을 입력하며 확장자는 .adoc 여야 합니다.

  3. ascii doc 문법으로 작성을 시작하면 우측의 outline 창에 전체 문서의 구조가 표시됩니다.

    테스트를 위해 ascii doc 으로 작성한 유명한 문서인 Mastering Bitcoin 원고의 일부 내용을 발췌했습니다.


  4. 어떻게 표시될 지 여부는 하단의 Preview  를 클릭하면 rendering 해서 보여주므로 의도대로 작성하고 있는지 확인할 수 있습니다.


같이 보기