마크다운 표 생성기

마크다운 표가 실제로 무엇인가

마크다운 표는 원래의 마크다운 명세에 포함되어 있지 않습니다. 이는 GitHub가 대중화하여 이제는 개발자들이 글을 쓰는 거의 모든 곳에서 지원되는 방언인 GitHub Flavored Markdown에서 비롯되었습니다. 문법은 일부러 일반 텍스트로 되어 있습니다. 열은 파이프 문자로 구분되고, 헤더 행이 맨 위에 오며, 두 번째 줄의 대시들이 헤더와 본문을 나눕니다. 그저 텍스트이기 때문에, 마크다운 표는 원시 형태에서도 읽을 수 있고, HTML 표는 결코 해내지 못하는 방식으로 복사-붙여넣기와 버전 관리의 diff, 이메일을 견뎌 냅니다.

이 도구는 그 파이프들을 줄 맞추는 수고를 덜어 줍니다. 평범한 행을 붙여넣으면 도구가 열을 파악하고, 헤더와 구분 행, 그리고 모든 셀이 제자리에 들어간 올바른 형식의 표를 작성해 줍니다.

문법의 해부

최소한의 표는 세 줄처럼 생겼습니다. 첫 줄은 파이프로 구분된 헤더를 나열하는데, 예를 들면 Name 다음에 파이프, 그리고 Role 식입니다. 둘째 줄은 구분자입니다. 열마다 대시 한 무더기씩, 이를테면 대시 셋, 파이프, 대시 셋 같은 식입니다. 그다음의 모든 줄은 같은 파이프 패턴을 쓰는 데이터 행입니다. 각 줄의 시작과 끝에 있는 바깥쪽 파이프는 GFM에서 선택 사항이지만, 그것을 넣으면 원시 텍스트가 읽기 쉬워지며 이 생성기가 만들어 내는 것도 바로 그 형태입니다.

구분 행은 두 가지 역할을 합니다. 위의 줄이 헤더임을 알리는 동시에, 콜론의 배치를 통해 각 열이 어떻게 정렬되는지를 선언합니다. 마크다운 표가 렌더링되려면 적어도 헤더 행과 구분 행이 항상 필요한 것은 바로 이 때문입니다.

열 정렬 지정하기

정렬은 전적으로 구분 행의 대시 안에 들어 있으며, 콜론으로 제어됩니다. 대시 왼쪽의 콜론은 열을 왼쪽 정렬하고, 양쪽의 콜론은 가운데 정렬하며, 오른쪽의 콜론은 오른쪽 정렬합니다. 그래서 가운데 정렬 열은 콜론, 대시 몇 개, 그다음 콜론으로 쓰고, 오른쪽 정렬 열은 콜론으로 끝납니다. 자릿수가 자리값에 따라 줄 맞춰지도록, 숫자 열에는 오른쪽 정렬이 관습적인 선택입니다.

이 도구에서 왼쪽, 가운데, 오른쪽을 선택하면 표 전체에 걸쳐 그 콜론 표시를 대신 넣어 줍니다. 이는 정렬이 독자의 설정에 좌우되지 않고 GitHub와 문서 생성기, 그 밖의 어떤 GFM 뷰어에서도 동일하게 렌더링됨을 뜻합니다.

실제 예시

쉼표로 구분된 세 줄을 붙여넣습니다. 맨 위에 Name, Role, City를 두고, 이어서 Ada Lovelace, Engineer, London과 Grace Hopper, Admiral, New York을 둡니다. 가운데 정렬을 선택하면 도구는 세 개의 제목으로 된 헤더 행, 각 열의 대시가 콜론으로 감싸인 구분 행, 그리고 두 개의 데이터 행을 내보냅니다. 이것을 GitHub의 README에 붙여넣으면, 값이 가운데 정렬된 깔끔한 세 열짜리 표로 렌더링되며, 파이프를 손으로 세어 볼 필요가 없습니다.

파이프 이스케이프와 그 밖의 함정

파이프는 열 구분자이므로, 셀 안에 글자 그대로의 파이프가 있으면 평소라면 그 셀을 둘로 나누어 표를 망가뜨립니다. 이 도구는 데이터 안의 모든 파이프를 백슬래시 뒤에 파이프를 붙인 형태로 작성해 자동으로 이스케이프하므로, OR 기호가 들어간 논리식 같은 값도 한 셀 안에 머무르며 의도대로 표시됩니다.

알아 둘 것이 두 가지 더 있습니다. 마크다운 표는 Enter 키를 써서 셀 안에 강제 줄 바꿈을 담을 수 없습니다. 셀 안에서 줄을 바꿔야 한다면, GFM이 인라인 HTML을 허용하므로 명시적인 br 태그를 넣게 됩니다. 그리고 모든 행은 헤더와 같은 수의 열을 가져야 합니다. 행에 셀이 더 많으면 대부분의 렌더러가 이를 무시하고, 셀이 모자라면 빈 칸으로 렌더링되므로, 예측 가능한 결과를 위해 행을 직사각형으로 유지하세요.

구분자와 따옴표로 묶인 값

실제 데이터가 늘 쉼표로 구분되어 도착하는 것은 아닙니다. 구분자를 자동(Auto)으로 두면 도구가 행이 쉼표, 탭, 파이프 중 무엇을 쓰는지 감지하므로, 스프레드시트에서 곧바로 복사한 블록(탭 구분)과 CSV로 내보낸 데이터(쉼표 구분)가 모두 별도 설정 없이 변환됩니다. 자동 감지가 잘못 짐작할 법한 경우, 이를테면 쉼표가 정당하게 많이 들어 있는 데이터라면, 특정 구분자를 강제로 지정할 수도 있습니다.

따옴표로 묶인 CSV 값도 올바르게 처리됩니다. 큰따옴표 안의 쉼표는 값의 일부로 취급되므로, 성을 먼저 적어 따옴표로 묶은 항목 같은 필드가 두 열로 쪼개지지 않고 한 셀에 그대로 남습니다. 스프레드시트 내보내기는 구분자 자체를 포함한 값이라면 으레 따옴표로 묶기 때문에 이 점이 중요합니다.

마크다운 표가 통하는 곳과 통하지 않는 곳

마크다운 표는 개발과 글쓰기 환경에서 빛을 발합니다. GitHub와 GitLab의 README, 이슈, 풀 리퀘스트, 정적 사이트 및 문서 생성기, 여러 위키와 노트 앱, Slack과 Discord 같은 채팅 도구의 마크다운 인식 입력란, 그리고 Reddit 댓글이 그 예입니다. GFM이 지원되는 곳이라면 어디서든 붙여넣은 표가 그냥 작동하며 소스 형태로도 읽기 좋게 유지됩니다.

하지만 보편적이지는 않습니다. GFM 확장이 없는 일반 마크다운은 표를 이해하지 못하고, 일부 경량 렌더러는 표를 무시하는데, 그런 경우에는 원시 파이프가 그대로 드러납니다. 마크다운 표는 세밀한 스타일 제어와 셀 병합, 중첩 구조도 갖추지 못했습니다. 정밀한 서식이나 colspan, 풍부한 스타일이 필요할 때는 HTML 표가 더 나은 선택입니다. 깔끔하고 버전 관리가 가능하며 사람이 읽기 좋은 표를 원할 때는 마크다운이 이깁니다.