마크다운 표·HTML 테이블·JSON 상호 변환 원리와 주의할 점

마크다운 표(파이프 문법)와 HTML <table> 태그, JSON 객체 배열은 표현 방식만 다를 뿐 담긴 데이터, 즉 제목 행과 값 행은 동일합니다. 이 글은 세 포맷이 서로 어떤 규칙으로 대응되는지, 그리고 열 개수가 안 맞거나 헤더 구분선이 없을 때 실제로 어떻게 처리되는지를 설명합니다.
요약 ① 마크다운 표의 첫 줄은 제목 행이고, 둘째 줄에
-문자가 있는지로 구분선인지를 판단합니다. ② HTML은<tr>안의<th>/<td>를, JSON은 첫 번째 객체의 키(key)를 제목 행으로 씁니다. ③ 행마다 칸 개수가 달라도 자동으로 빈칸을 채우거나 초과분을 버리므로 직접 맞출 필요는 없습니다.
마크다운 표를 HTML·JSON으로 옮길 때 막히는 지점
블로그 글에는 마크다운 표를 썼는데 정작 사이트에는 HTML로 붙여야 하거나, 반대로 API가 내려준 JSON 배열을 문서용 마크다운 표로 바꿔야 하는 상황이 자주 생깁니다. 표 한두 개면 손으로 옮겨도 되지만, 행이 수십 개를 넘어가면 파이프(|) 위치를 세거나 <td> 태그를 하나씩 여는 작업에서 오탈자가 나기 쉽습니다.
세 포맷을 손으로 옮기는 방법: 규칙은 하나입니다
세 포맷 모두 데이터를 '제목 행' 하나와 '값 행' 여러 개로 나눠서 표현합니다. 포맷 간 차이는 이 두 덩어리를 감싸는 문법뿐입니다.
- 마크다운 → HTML: 첫 줄의 각 칸을
<th>로, 이후 줄(구분선 줄은 제외)의 각 칸을<td>로 바꾸고, 줄마다<tr>로 감쌉니다. - HTML → 마크다운:
<tr>하나를 한 줄로 바꾸고, 그 안의<td>/<th>값을|로 구분해 나열한 뒤, 제목 행 다음 줄에|---|---|형태의 구분선을 넣습니다. - JSON → 마크다운/HTML: 배열의 첫 번째 객체가 가진 키 이름들이 제목 행이 되고, 각 객체의 값이 그 키 순서대로 한 행이 됩니다.
이 세 규칙만 있으면 표가 몇 개든 손으로도 옮길 수 있지만, 행이 많아지면 실수가 잦아집니다. 붙여넣기만 하면 같은 규칙을 그대로 적용해 나머지 두 포맷을 동시에 보여주는 도구를 아래에서 바로 써볼 수 있습니다.
변환하고자 하는 마크다운 표 소스나 HTML 태그 또는 JSON 데이터를 입력창에 넣어 다른 포맷의 테이블 데이터로 즉시 확인해 보세요.

자주 막히는 지점
| 상황 | 실제 처리 방식 |
|---|---|
마크다운 둘째 줄에 구분선(-)이 없음 | 구분선으로 인식하지 못해 둘째 줄이 그대로 데이터 행 하나로 들어갑니다 |
| 행마다 칸 개수가 다름 | 제목 행보다 칸이 모자라면 빈 문자열로 채우고, 많으면 초과분을 버립니다 |
HTML에 헤더 행(<th>)과 본문 행(<td>)이 나뉘어 있음 | 제목 행은 정상 인식되지만, 헤더가 있던 <tr>이 첫 데이터 행으로 한 번 더 들어갈 수 있어 결과 첫 줄이 제목과 같은 텍스트인지 확인해야 합니다 |
| JSON 배열의 객체마다 키 구성이 다름 | 첫 번째 객체의 키만 제목 행으로 쓰이고, 다른 객체에만 있는 키의 값은 결과에 반영되지 않습니다 |
정리
세 포맷은 '제목 행 + 값 행'이라는 같은 구조를 다른 문법으로 담은 것뿐입니다. 손으로 옮길 때도 이 대응 규칙만 지키면 되고, 변환기는 그 규칙을 매 입력마다 자동으로 적용해 결과를 보여줍니다. 다만 헤더 구분선 유무, 칸 개수 불일치, HTML 헤더 행 중복처럼 실제로 자주 걸리는 지점은 위 표를 기준으로 결과를 한 번 눈으로 확인하는 편이 안전합니다.
변환하고자 하는 마크다운 표 소스나 HTML 태그 또는 JSON 데이터를 입력창에 넣어 다른 포맷의 테이블 데이터로 즉시 확인해 보세요.
자주 묻는 질문
표에 병합된 셀(rowspan·colspan)이 있어도 되나요?
세 포맷 모두 '제목 행 + 값 행'만 다루므로 병합된 셀은 지원하지 않습니다. 병합을 풀어 각 칸에 값을 채운 뒤 입력해야 합니다.
변환 결과에 제목 행과 같은 내용이 한 번 더 나오면 어떻게 하나요?
HTML 입력에 <th>가 담긴 <tr>이 헤더용으로 따로 있으면, 그 줄이 데이터 행으로도 한 번 더 들어갈 수 있습니다(위 표 참고). 변환 결과에서 그 줄만 지우면 됩니다.
셀 안에 줄바꿈이나 | 문자가 들어가도 되나요?
마크다운 형식에서는 | 자체가 칸 구분자이므로 셀 안에 파이프 문자가 있으면 표가 잘못 나뉩니다. 줄바꿈도 새로운 줄로 해석되어 표가 깨지므로 값 안에는 넣지 않는 편이 안전합니다.