마크다운 표 생성기를 쓰는 이유
마크다운 표는 일반 텍스트입니다. 한 줄이 한 행이고, 셀은 파이프로 구분하며, 헤더 아래에는 대시로 된 구분 행이 들어갑니다. 읽기는 쉽지만 직접 입력하기는 번거롭고, 열을 손으로 맞추는 일은 지루합니다. 값 하나가 길어지면 다른 행을 모두 다시 맞춰야 합니다.
이 마크다운 표 만들기 도구는 작은 스프레드시트 같은 그리드를 제공하고, 마크다운은 알아서 써 줍니다. 엑셀이나 Google 스프레드시트에서 복사한 셀, CSV 텍스트, 기존 마크다운 표처럼 이미 가진 데이터도 읽어 옵니다.
그리드 사용 방법
- 아무 셀에나 입력합니다. 첫 행은 헤더이며 굵게 표시됩니다.
- 행 추가와 열 추가로 표를 늘립니다. 각 행 옆과 각 열 위의 작은 × 버튼으로 해당 행이나 열을 지웁니다.
- Enter를 누르면 아래 행으로 이동합니다. 마지막 행에서 Enter를 누르면 새 행이 생깁니다.
- 정렬: 각 열 위의 선택 상자에서 기본, 왼쪽, 가운데, 오른쪽을 고릅니다.
- 셀 묶음을 아무 셀에나 붙여넣으면 그 위치부터 그리드가 채워집니다.
- 데이터 붙여넣기를 누르면 스프레드시트 셀, CSV, 마크다운 표를 넣을 입력란이 열립니다. 표에 불러오기를 누르면 그 내용으로 그리드를 바꿉니다.
- 행/열 바꾸기는 표의 행과 열을 뒤집습니다.
- 예시는 예제 표를 불러오고, 지우기는 빈 3×3 그리드로 다시 시작합니다.
마크다운은 그리드 아래에 나타납니다. 열 맞추기는 모든 셀에 공백을 채워 일반 텍스트로도 표가 잘 읽히게 합니다. 가장 짧은 결과가 필요하면 끄세요. 복사는 클립보드에 넣고, 다운로드는 .md 파일로 저장합니다.
예시
첫 열은 왼쪽, 가격은 오른쪽, 사용자 수는 가운데로 정렬한 간단한 요금표입니다.
| Plan | Price | Users |
| :------- | ----: | :-------: |
| Free | $0 | 1 |
| Team | $12 | 10 |
| Business | $30 | Unlimited |구분 행의 콜론이 정렬을 정합니다. 콜론이 왼쪽에 있으면 왼쪽, 오른쪽에 있으면 오른쪽, 양쪽에 있으면 가운데 정렬입니다. 열 맞추기를 끄면 같은 표가 공백 없이 쓰입니다.
| Plan | Price | Users |
| :-- | --: | :-: |
| Free | $0 | 1 |
| Team | $12 | 10 |
| Business | $30 | Unlimited |두 버전은 똑같이 렌더링됩니다. 공백을 채운 쪽은 텍스트 파일에서 읽고 고치기 쉽고, 압축된 쪽은 더 짧아서 값 하나만 바뀌었을 때 diff가 작습니다.
셀 안의 특수문자
셀 안의 파이프는 셀을 일찍 끝내 버리므로 생성기가 이스케이프합니다. 스프레드시트에서 붙여넣을 때 생길 수 있는 셀 안의 줄바꿈은 <br>이 됩니다.
| Command | Meaning |
| -------------- | ----------- |
| a \| b | pipe output |
| line1<br>line2 | two lines |**bold**, 링크, 인라인 코드 같은 다른 마크다운 문법은 셀 안에서도 그대로 유지되어 평소처럼 렌더링됩니다.
한글이 들어간 표의 열 맞춤
공백을 채울 때 중국어, 일본어, 한국어 문자는 2칸 너비로 계산합니다. 대부분의 고정폭 글꼴에서 그렇게 보이기 때문입니다. 덕분에 그런 글꼴을 쓰는 에디터에서 파이프가 가지런히 맞습니다. 위 요금표를 한글로 만들어 이 도구에서 실제로 출력한 결과입니다.
| 요금제 | 가격 | 사용자 |
| :------- | -------: | :----: |
| 무료 | 0원 | 1명 |
| 팀 | 12,000원 | 10명 |
| 비즈니스 | 30,000원 | 무제한 |비즈니스는 4글자지만 8칸으로 계산되어 요금제(6칸) 뒤에 공백 2칸이 붙었습니다. 한글을 영문 폭의 2배로 그리는 고정폭 글꼴(D2Coding 등)에서는 줄이 맞고, 비례폭 글꼴에서는 맞지 않아 보일 수 있지만 렌더링 결과에는 영향이 없습니다.
마크다운 표를 쓸 수 있는 곳
GitHub, GitLab, Bitbucket, Obsidian, Reddit, 그리고 대부분의 정적 사이트 생성기가 이 표 문법을 지원합니다. 이 문법은 GitHub Flavored Markdown에서 왔습니다. 원래 마크다운에는 표가 없었기 때문에 아주 오래된 렌더러는 파이프를 그대로 보여 줄 수 있습니다.
팁
- 표는 좁게 유지하세요. 긴 문장은 문단으로 쓰는 편이 낫습니다. 짧은 열 3개에서 6개 정도인 표가 휴대폰에서 가장 읽기 좋습니다.
- 데이터가 이미 스프레드시트에 있다면 거기서 시작하세요. 범위를 복사해 첫 셀에 붙여넣고 정렬만 조정하면 됩니다.
- 긴 문서 안의 표를 정리하려면 문서 전체를 마크다운 포매터에 붙여넣으세요. 표를 같은 방식으로 맞춰 줍니다.
- 표보다 JSON이 필요한 데이터라면 CSV JSON 변환기를 쓰세요.
- 웹 페이지의 HTML 표를 마크다운으로 바꾸려면 HTML 마크다운 변환기를 쓰세요.
마크다운 표를 만드는 다른 방법
- VS Code: Markdown All in One 같은 확장은 문서를 포맷할 때 표를 제자리에서 정리해 줍니다.
- Pandoc은 명령줄에서 CSV나 스프레드시트 내보내기 파일을 마크다운 표로 바꿀 수 있습니다.
- Google 스프레드시트: 마크다운 내보내기 기능은 없지만, 셀을 복사해 여기에 붙여넣으면 몇 초면 됩니다.
모든 처리는 브라우저에서 이루어집니다. 붙여넣은 데이터는 어디로도 전송되지 않습니다.