[리눅스 팁] Asciidoc 사용법

Asciidoc 사용법

Asciidoc은 문서 작성 및 형식을 지정하는 데 사용되는 마크업 언어입니다. 이는 다양한 문서 형식을 생성할 수 있으며, 특히 기술 문서와 같은 정형화된 문서 작성에 유용합니다. 여기서는 Asciidoc의 기본적인 사용법과 주요 기능들을 소개합니다.

caption: AsciiDoc 홈페이지

기본 문법

제목

Asciidoc에서는 제목을 = 문자를 사용하여 표시합니다. 제목의 레벨에 따라 =의 개수가 달라집니다.

= 문서 제목
== 1단계 제목
=== 2단계 제목
==== 3단계 제목

단락

일반적인 단락은 별도의 구문 없이 작성할 수 있습니다. 단락 사이에는 빈 줄을 넣어 구분합니다.

이것은 첫 번째 단락입니다.

이것은 두 번째 단락입니다.

목록

Asciidoc에서는 여러 종류의 목록을 작성할 수 있습니다.

순서 없는 목록

*, -, + 기호를 사용하여 순서 없는 목록을 작성합니다.

* 항목 1
* 항목 2
** 하위 항목 1
** 하위 항목 2

순서 있는 목록

숫자를 사용하여 순서 있는 목록을 작성합니다.

. 첫 번째 항목
. 두 번째 항목
.. 하위 항목 1
.. 하위 항목 2

코드 블록

코드 블록은 [source]와 ----를 사용하여 작성합니다.

[source,python]
----
print("Hello, Asciidoc!")
----

인라인 코드

인라인 코드는 ` 기호를 사용하여 작성합니다.

이것은 `인라인 코드` 예시입니다.

표

표를 작성하는 방법은 다음과 같습니다.

|===
|이름 |나이 |직업

|홍길동 |30 |개발자
|김철수 |25 |디자이너
|===

링크

링크는 다음과 같이 작성합니다.

Asciidoc 공식 사이트는 http://asciidoc.org[여기]입니다.

이미지

이미지는 image:: 구문을 사용하여 삽입합니다.

image::path/to/image.png[이미지 설명]

Asciidoc을 HTML로 변환하기

Asciidoc 파일을 HTML로 변환하려면 asciidoctor 도구를 사용할 수 있습니다. 다음은 기본적인 변환 명령어입니다.

asciidoctor 파일이름.adoc

이 명령어를 실행하면 같은 디렉터리에 HTML 파일이 생성됩니다.

caption: Markdown과 AsciiDoc

정리

Asciidoc은 다양한 문서 형식을 작성하는 데 유용한 마크업 언어입니다. 기본적인 문법을 통해 제목, 단락, 목록, 코드 블록, 표, 링크, 이미지를 쉽게 작성할 수 있으며, asciidoctor 도구를 사용하여 HTML로 변환할 수 있습니다. 이를 통해 문서 작성의 효율성을 높일 수 있습니다.