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

발행수정도구Markdown ↔ HTML ↔ JSON 테이블 양방향 변환기

목차
  1. 마크다운 표를 HTML·JSON으로 옮길 때 막히는 지점
  2. 세 포맷을 손으로 옮기는 방법: 규칙은 하나입니다
  3. 자주 막히는 지점
  4. 정리
  5. 자주 묻는 질문

마크다운 표(파이프 문법)와 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: 배열의 첫 번째 객체가 가진 키 이름들이 제목 행이 되고, 각 객체의 값이 그 키 순서대로 한 행이 됩니다.

이 세 규칙만 있으면 표가 몇 개든 손으로도 옮길 수 있지만, 행이 많아지면 실수가 잦아집니다. 붙여넣기만 하면 같은 규칙을 그대로 적용해 나머지 두 포맷을 동시에 보여주는 도구를 아래에서 바로 써볼 수 있습니다.

Markdown ↔ HTML ↔ JSON 테이블 양방향 변환기

변환하고자 하는 마크다운 표 소스나 HTML 태그 또는 JSON 데이터를 입력창에 넣어 다른 포맷의 테이블 데이터로 즉시 확인해 보세요.

자주 막히는 지점

상황실제 처리 방식
마크다운 둘째 줄에 구분선(-)이 없음구분선으로 인식하지 못해 둘째 줄이 그대로 데이터 행 하나로 들어갑니다
행마다 칸 개수가 다름제목 행보다 칸이 모자라면 빈 문자열로 채우고, 많으면 초과분을 버립니다
HTML에 헤더 행(<th>)과 본문 행(<td>)이 나뉘어 있음제목 행은 정상 인식되지만, 헤더가 있던 <tr>이 첫 데이터 행으로 한 번 더 들어갈 수 있어 결과 첫 줄이 제목과 같은 텍스트인지 확인해야 합니다
JSON 배열의 객체마다 키 구성이 다름첫 번째 객체의 키만 제목 행으로 쓰이고, 다른 객체에만 있는 키의 값은 결과에 반영되지 않습니다

정리

세 포맷은 '제목 행 + 값 행'이라는 같은 구조를 다른 문법으로 담은 것뿐입니다. 손으로 옮길 때도 이 대응 규칙만 지키면 되고, 변환기는 그 규칙을 매 입력마다 자동으로 적용해 결과를 보여줍니다. 다만 헤더 구분선 유무, 칸 개수 불일치, HTML 헤더 행 중복처럼 실제로 자주 걸리는 지점은 위 표를 기준으로 결과를 한 번 눈으로 확인하는 편이 안전합니다.

Markdown ↔ HTML ↔ JSON 테이블 양방향 변환기

변환하고자 하는 마크다운 표 소스나 HTML 태그 또는 JSON 데이터를 입력창에 넣어 다른 포맷의 테이블 데이터로 즉시 확인해 보세요.

자주 묻는 질문

표에 병합된 셀(rowspan·colspan)이 있어도 되나요?

세 포맷 모두 '제목 행 + 값 행'만 다루므로 병합된 셀은 지원하지 않습니다. 병합을 풀어 각 칸에 값을 채운 뒤 입력해야 합니다.

변환 결과에 제목 행과 같은 내용이 한 번 더 나오면 어떻게 하나요?

HTML 입력에 <th>가 담긴 <tr>이 헤더용으로 따로 있으면, 그 줄이 데이터 행으로도 한 번 더 들어갈 수 있습니다(위 표 참고). 변환 결과에서 그 줄만 지우면 됩니다.

셀 안에 줄바꿈이나 | 문자가 들어가도 되나요?

마크다운 형식에서는 | 자체가 칸 구분자이므로 셀 안에 파이프 문자가 있으면 표가 잘못 나뉩니다. 줄바꿈도 새로운 줄로 해석되어 표가 깨지므로 값 안에는 넣지 않는 편이 안전합니다.

관련 글

  1. 텍스트 파일 합치기 방법과 인코딩 깨짐 방지 가이드여러 개로 쪼개진 텍스트(TXT) 파일을 한 번에 합치는 방법과 구분자·파일 헤더 옵션을 정리하고, 병합 후에도 한글이 깨지는 EUC-KR 인코딩 문제를 피하는 방법을 설명합니다.
  2. 더미 데이터 Mock JSON 생성 공식과 API 테스팅 가짜 객체 설계개발 단계 프론트엔드 테스트를 위해 UUID, 순차 ID, 가상 이메일, 난수 등으로 구성된 무작위 JSON 더미 데이터 생성 공식과 모의 네트워크 레이턴시 코드 기전을 해설합니다.
  3. 모스 부호 소리 변환 공식과 Web Audio API 주파수 설계 가이드모스 부호의 표준 소리 길이 공식(단점 1 Unit, 장점 3 Unit)과 웹 브라우저 오실레이터로 정현파 비프음을 합성하는 Web Audio API 제어법을 해설합니다.
  4. 모스 부호 디코딩 번역 공식과 알파벳 기호 1대1 매핑 사전짧은 신호(.)와 긴 신호(-)를 통한 알파벳/숫자 번역 매핑 딕셔너리 정보, 문자/단어 구분 규칙 및 텍스트 양방향 인코딩/디코딩 알고리즘을 해설합니다.
  5. 영문 이름 이니셜 추출 공식과 영문 표기법 대소문자 규격성과 이름의 순서 차이, 대소문자 정규화, 구분 마침표(.) 결합 방식 등 영문 이름 풀네임에서 이니셜을 추출하는 알고리즘과 비즈니스 활용법을 설명합니다.
  6. 컴퓨터 진법 변환 공식과 2진수 8진수 10진수 16진수 계산법컴퓨터 전산학의 2진수, 8진수, 10진수, 16진수 간 상호 변환 원리와 자바스크립트 toString/parseInt 활용법, 부동소수점 오차 원인을 해설합니다.

관련 도구