Markdown의 ‘표’는 왜 그렇게 귀찮을까요?

Markdown은 간편하게 글을 쓸 수 있다는 것이 매력이지만, ‘테이블(표)‘만큼은 예외라고 생각하는 분들이 많으실 겁니다.

Markdown 표 작성이 획기적으로 쉬워진다! 비주얼 에디터 활용법

파이프(|)와 하이픈(-)을 수작업으로 입력하며 줄을 맞추는 것은 시간이 꽤 걸리는 일입니다. 열이 늘어나거나 셀 안의 글자 수가 바뀔 때마다 다시 정렬해야 하는 작업은 무척 스트레스가 쌓이죠.

| 상품명 | 가격 | 재고 |
| --- | --- | --- |
| 사과 | 1,200원 | 있음 |
| 바나나 | 900원 | 없음 |

이런 간단한 표라면 모를까, 열의 개수가 많거나 한글과 같은 전각 문자가 포함되어 있으면 고정폭 글꼴 에디터에서도 줄이 어긋나 보이기 일쑤라 유지보수가 매우 힘들어집니다.

비주얼 에디터로 해결하세요

DevToolKits의 **Markdown 표 생성 도구**를 사용하면 엑셀이나 스프레드시트를 다루는 것처럼 직관적으로 표를 만들 수 있습니다.

주요 장점

  1. 직관적인 조작: 행이나 열의 추가·삭제를 버튼 클릭 한 번으로 할 수 있습니다. 표를 눈에 보이는 대로 입력하면 Markdown 형식으로 변환해 줍니다. 다만 Markdown 표에서는 셀 병합을 할 수 없습니다.
  2. CSV 임포트 지원: 이미 작성된 쉼표 구분 CSV 데이터를 붙여넣기만 하면 순식간에 Markdown으로 바꿔줍니다. 엑셀이나 스프레드시트에서 복사한 내용은 탭으로 구분되어 있어 그대로는 한 열로 뭉치므로, CSV로 내보낸 뒤 붙여넣으세요.
  3. 실시간 미리보기: 내용을 입력하는 즉시 Markdown 코드가 생성됩니다. 그대로 복사해서 Notion, GitHub, Zenn 등 여러분이 사용하시는 에디터에 붙여넣기만 하면 끝입니다.
  4. 정렬 설정: 왼쪽, 가운데, 오른쪽 정렬 설정도 아이콘 클릭만으로 각 열마다 개별적으로 지정할 수 있습니다.

활용 상황

  • README.md 작성: 프로젝트의 기능 목록이나 환경 변수 리스트를 만들 때.
  • 기술 블로그 포스팅: Zenn이나 벨로그(velog) 등에서 비교표를 넣고 싶을 때.
  • 사내 문서 관리: 사양서나 변경 이력을 표로 깔끔하게 정리하고 싶을 때.

보기 좋은 Markdown 표를 만드는 요령

Markdown 표는 만드는 것만큼 “읽기 쉽게 유지하는 것”도 중요합니다. 다음 점을 의식하면 README나 글의 표가 훨씬 보기 좋아집니다.

  • 열 수를 너무 늘리지 않는다
  • 긴 설명은 별도 문단으로 뺀다
  • 숫자는 오른쪽 정렬, 항목 이름은 왼쪽 정렬로 한다
  • 필수/선택 같은 값의 표기를 통일한다
  • 스마트폰에서 가로로 너무 길어지지 않는지 확인한다

특히 기술 글에서는 표가 가로로 너무 길면 스마트폰에서 읽기 어렵습니다. 열을 늘리기보다 중요한 정보만 표에 넣고 보충은 본문에서 설명하는 편이 친절합니다.

CSV 읽기와 출력의 실제 동작

Markdown 표 생성 도구에 CSV를 붙여넣었을 때의 동작을 실제 입력으로 확인합니다.

name,price,note
Apple,120,"red, sweet"
"Say ""hi""",5

日本語,300,

이 CSV를 가격 열은 오른쪽 정렬, 비고 열은 가운데 정렬로 출력한 결과입니다.

| name     | price | note       |
| :-------- | -----: | :----------: |
| Apple    | 120   | red, sweet |
| Say "hi" | 5     |            |
| 日本語      | 300   |            |
  • 따옴표로 감싼 쉼표("red, sweet")는 하나의 셀로 읽힙니다. ""는 " 한 글자가 됩니다
  • 빈 줄은 무시되고, 셀 앞뒤의 공백은 제거됩니다
  • 열이 모자란 줄("Say ""hi""",5)은 빈 셀로 채워집니다
  • 구분 줄은 왼쪽 정렬이 :---, 오른쪽 정렬이 ---:, 가운데 정렬이 :---:입니다(왼쪽 정렬에도 콜론이 붙습니다)
  • 자리 맞춤은 글자 수로 하므로, 전각 일본어가 들어간 열은 고정폭 글꼴에서도 세로가 어긋나 보입니다. Markdown으로 표시될 때는 영향이 없습니다
  • 셀 안의 |는 이스케이프되지 않습니다. |가 들어간 값은 출력 후 \|로 고치세요

2026년 11월에 추가된 기능

  • 다른 형식으로 변환: 만든 표를 HTML, LaTeX, 테두리 텍스트 표, JSON, SQL INSERT, TSV로 변환할 수 있습니다(전각은 2칸, SQL은 따옴표 이중화, LaTeX·HTML은 특수 문자 이스케이프).
  • 행과 열 바꾸기(전치)와 열 기준 정렬(숫자/문자열, 내림차순)도 지원합니다.

도구에서 직접 해 보기

자주 묻는 질문

Excel이나 스프레드시트에서 붙여 넣을 수 있나요?

쉼표로 구분된 CSV로 붙여 넣으면 Markdown 표로 변환됩니다. Excel이나 스프레드시트에서 복사한 셀은 탭으로 구분되어 있어 그대로는 열로 나뉘지 않습니다. 먼저 CSV로 내보낸 뒤 붙여 넣으세요.

Markdown 표에서 셀 병합이 가능한가요?

표준 Markdown 표에서는 불가능합니다. HTML의 colspan, rowspan에 해당하는 문법이 없습니다. 복잡한 배치가 필요하다면 병합이 필요 없도록 열 구성을 다시 생각하거나, 표 주변의 본문에서 보충 설명하는 편이 좋습니다. 그래야 렌더러가 달라져도 그대로 표시됩니다.

GitHub README에서도 쓸 수 있나요?

쓸 수 있습니다. GitHub Flavored Markdown이 표 문법을 지원하므로, 생성한 Markdown을 README에 그대로 붙여 넣으면 표로 표시됩니다.

마치며

“이제 Markdown 표는 수작업으로 하지 않겠다”고 결심하는 것만으로도 문서 작성 속도는 비약적으로 향상됩니다.

구조가 바뀌거나 데이터가 추가되었을 때도 도구에 다시 붙여넣어 편집하고 복사해 오면 정렬이 깔끔하게 완료됩니다. 지금 바로 **Markdown 표 생성 도구**를 북마크하고 쾌적한 기록 생활을 즐겨보세요!