[markdown] 마크다운 태그의 종류 기초
마크다운에서 사용하는 태그의 종류는 다음과 같습니다.
태그 종류가 많지 않고, 종류별로 유사하게 사용하기 때문에 5분 정도만 투자해도 기본적인 마크다운 문서는 작성할 수 있습니다.
복잡한 태그들을 사용할 일이 없겠다 싶으면 앞쪽의 문서 구조 태그(제목, 목록)와 강조, 링크 태그 정도만 숙지하고 사용해도 구조화된 문서 작성에 아무 문제가 없습니다.
어떤 종류의 태그가 있고, 용도가 무엇인지만 파악하고 넘어가면 됩니다. 뒤에서 태그 종류별로 자세하게 설명을 합니다. 사용빈도가 높은 중요한 태그 순서로 나열되어 있습니다.
- 제목: 제목을 6단계로 표시합니다. # ~ ###### 지 샵의 개수가 많아지면서 제목의 레벨이 내려갑니다. HTML의 <H1> ~ <H6> 태그처럼 글자 크기로 구분을 합니다.
- 목록: 순서 있는 목록과 순서 없는 목록 2가지가 있습니다. 순서 있는 목록은 “숫자. [내용]”으로 “숫자 뒤에 점을 찍고 공백으로 띄워” 순서 있는 목록임을 표시합니다.
순서 없는 목록은 “숫자.” 대신 *, +, - 기호로 불릿 타입을 표시합니다. 불릿은 마크다운 뷰어에 따라 다르게 표시됩니다. 보통은 타입 구분 없이 디스크(“●”) 모양으로 출력합니다. - 강조: 문구를 강조합니다. 문구 앞뒤에 공백없이 기호(*, _, **, __, ~~)를 붙여 표시해 문구를 강조(볼드, 이탤릭, 취소선) 표시할 수 있습니다. 반드시 앞뒤에 쌍으로 넣어야 합니다.
- 줄 바꿈 : 문장 맨 끝에 공백 3개를 연달아 표시합니다.
- 수평선: 한 행에 다른 내용 없이 *, - 문자가 같은 문자로 3개 이상 있으면 수평선 으로 표시합니다. 행에는 다른 내용이 없어야 하며, 공백으로 띄어서 표시할 수도 있습니다. 특정 뷰어에서는 페이지 나눔 기호로 사용하기도 합니다.
- 테이블: 파이프 문자(|)로 외곽선을 그려 테이블을 작성합니다. 파이프 기호로 셀의 경계 표시(테이블의 좌우 외곽선)를 해서 필요한 개수만큼 열을 생성합니다. 여러 행을 연달아 작성하면 하나의 테이블이 됩니다. 단순한 구조의 일반 테이블만 만들 수 있습니다.
정해진 규칙에 따라 작성해야 테이블로 인식되는 제약사항이 있으므로 규칙에 맞춰 작성해야 합니다. - 링크: 같은 문서 안의 참조 링크(로컬 링크), 또는 외부 URL을 연결하는 일반 하이퍼링크 2가지로 구분됩니다. 이메일 주소와 웹 URL에는 자동으로 적절한 링크를 생성할 수도 있습니다.
- 이미지: 외부 이미지를 연결해 표시합니다. 대체 텍스트(Alternate Text)와 경로를 정해진 규칙에 맞춰 작성()하면 마크다운 뷰어에서 이미지를 표시합니다. 이미지 크기 제어는 지원하지 않습니다. 1:1로만 표시됩니다.
- 인용구: 인용구를 표시합니다. 뷰어에서는 텍스트 내용 왼쪽에 두꺼운 세로줄이 표시됩니다. 텍스트 내용 앞에 “> ”를 붙여 인용구를 작성합니다. 행마다 연달아 “> ” 표시를 하면 인접한 행들이 하나의 인용구 블록으로 묶음 처리됩니다. 왼쪽에 세로바를 표시하는 대신 해당 문구 전체를 박스로 감싸서 인용구 표현을 하는 뷰어도 있습니다.
- 코드블록: 소스코드 행/블록을 생성합니다. 행 단위 소스코드 블록은 텍스트 앞에 4개의 공백(또는 탭 하나)를 연달아 표시하면 적용됩니다.
여러 줄의 소스코드를 블록으로 처리할 때는 소스코드 위와 아래 빈 행에 백틱 3개(```)를 연달아 표시해 블록 박스 처리 및 코드 하이라이팅을 합니다. 소스코드 시작 백틱(```) 뒤에 붙여서 언어 종류를 표시해 하이라이팅 할 언어를 지정할 수도 있습니다. 하이라이팅은 마크다운 확장 기능으로 구형 마크다운 뷰어에서는 지원되지 않을 수도 있습니다.
마크다운 태그는 기본적으로 입력하는 텍스트 맨 앞에 의미를 가지는 특수문자, 또는 문자열로 마크다운 태그를 표시합니다. 예외적으로 줄 바꿈, 문구 강조 정도가 텍스트 중간이나 끝에 올 수 있습니다.
마크다운 태그들은 텍스트 내용 자체의 가독성에 영향을 주지 않기 때문에 전용의 뷰어 없이도 텍스트 내용을 읽는데 아무런 문제가 없습니다.
가장 큰 제목을 표시하려면 “#” 태그 뒤에 공백 하나를 띄워서 텍스트 내용을 작성합니다. 앞에 아무런 마크다운 태그가 없으면 일반 텍스트 입력입니다.