DevToolPal
한국어

CSV → Markdown 표 변환기

CSV나 TSV를 README, 문서, GitHub 이슈에 쓸 수 있도록 깔끔하게 정렬된 Markdown 표로 변환합니다.

로컬에서 실행, 업로드 없음

옵션

입력

0자 · 0 B

출력

0자 · 0 B

이 도구는

Markdown 표를 직접 입력하는 건 번거롭습니다. 행마다 파이프가 필요하고, 둘째 줄에는 하이픈을 써야 하며, 열을 손으로 맞추려면 한참 걸립니다. 이 도구는 CSV나 TSV 데이터를 GitHub Flavored Markdown 표로 변환해 README, 풀 리퀘스트, 이슈, 위키 등 Markdown을 쓰는 문서에 바로 붙여 넣을 수 있게 합니다.

CSV를 제대로 파싱하므로 쉼표가 든 따옴표 필드, 두 번 쓴 따옴표, 여러 줄 셀도 처리합니다. 출력은 공백으로 채워 일반 텍스트에서도 열이 맞춰지므로 나중에 읽고 고치기 쉽습니다.

사용 방법

  1. CSV나 TSV를 붙여 넣거나, .csv 또는 .tsv 파일을 업로드하거나, 예시 를 누릅니다.
  2. 정렬 을 고릅니다: 기본, 왼쪽, 가운데, 오른쪽, 또는 숫자만 있는 열을 오른쪽 정렬하는 숫자만 오른쪽.
  3. 첫 행이 열 이름이라면 첫 행은 헤더 를 켜 둡니다. 끄면 헤더는 Column 1, Column 2 등이 됩니다.
  4. 공백을 채우지 않은 간결한 행을 원하면 열 너비 맞추기 를 끕니다.
  5. 표를 복사하거나 .md 파일로 내려받습니다.

헤더보다 셀이 적은 행은 빈 셀로 채워지므로 표는 항상 올바른 형태가 됩니다.

예시

다음 CSV는:

Tool,Stars,Notes
ripgrep,48000,"Fast, recursive search"
fd,34000,find | but friendlier

숫자만 오른쪽 정렬을 고르면 다음 Markdown 표가 됩니다:

| Tool    | Stars | Notes                  |
| ------- | ----: | ---------------------- |
| ripgrep | 48000 | Fast, recursive search |
| fd      | 34000 | find \| but friendlier |

따옴표 필드 안의 쉼표는 셀에 남고, 파이프는 이스케이프되며, 숫자 열에는 --: 표시가 붙어 렌더링 시 오른쪽 정렬됩니다.

팁

  • 둘째 줄의 정렬 표시(:--, :-:, --:)가 렌더링된 표에서 각 열의 정렬을 정합니다.
  • 셀 안의 **굵게**, 인라인 코드, 링크 같은 인라인 Markdown은 그대로 유지되며 대부분의 뷰어에서 렌더링됩니다.
  • 너무 넓은 표는 작은 화면에서 읽기 어려우니 열을 여러 표로 나누는 것도 고려하세요.
  • HTML 표를 만들거나 JSON 배열을 Markdown 표로 바꾸려면 아래 관련 도구를 사용하세요.

자주 묻는 질문

› 어떤 Markdown 표 형식인가요?

GitHub Flavored Markdown(GFM) 파이프 표입니다. GitLab, Bitbucket, Notion, Obsidian, Docusaurus, MkDocs와 대부분의 정적 사이트 생성기도 지원합니다. 순수 CommonMark에는 표 문법이 없습니다.

› 셀 안의 파이프와 줄바꿈은 어떻게 되나요?

파이프는 셀을 끝내 버리므로 \|로 씁니다. 표의 한 행 안에서는 줄을 바꿀 수 없으므로 줄바꿈은 <br> 태그가 되며, GitHub와 대부분의 렌더러가 줄바꿈으로 표시합니다.

› 한국어, 중국어, 일본어 열도 정렬되는 이유는 무엇인가요?

열 너비 맞추기를 켜면 표시 너비 기준으로 공백을 채웁니다. 동아시아 전각 문자는 두 칸으로 계산하므로 고정폭 글꼴 편집기에서도 원본 Markdown이 정렬되어 보입니다. 렌더링된 표는 어느 쪽이든 같습니다.

› Excel이나 Google 스프레드시트에서 복사한 내용도 변환할 수 있나요?

네. 스프레드시트에서 복사한 셀은 탭으로 구분되며, 구분자는 자동으로 감지됩니다. 탭을 직접 고를 수도 있습니다.