ViewCSVCSV 파일을 열거나 붙여넣으면 옵션 옆에 파이프 표가 나타나 README, 이슈, 위키 페이지에 바로 쓸 수 있습니다. 값 안의 |는 \|로 써서 셀이 갈라지지 않게 하고, 셀 안의 줄 바꿈은 <br>로 바꾸며, 숫자 열은 오른쪽으로 정렬합니다. 파일은 업로드되지 않고 브라우저 안에서 변환됩니다.
CSV를 Markdown으로 변환하는 방법
- 파일 열기를 누르거나,
.csv,.tsv,.txt파일을 도구 위에 끌어다 놓거나, 붙여넣기를 고르세요. 구분 기호는 자동으로 감지되며, 잘못 추측했다면 가져오기 설정에서 구분 기호, 인코딩, 첫 행이 열 이름(머리글)임을 지정하세요. - 열 정렬과 셀 안의 줄 바꿈을 쓰는 방식을 고르세요. Markdown 탭에 다운로드 파일에 들어갈 텍스트가 그대로 표시됩니다.
- 복사를 눌러 GitHub, GitLab, 편집기에 표를 바로 붙여넣거나, Markdown 다운로드로
.md파일을 저장하세요.
파일에 머리글 행이 없다면 첫 행이 열 이름(머리글)임을 끄세요. Markdown 표에는 항상 머리글이 필요하므로 열 이름이 Column 1, Column 2처럼 붙습니다. 같은 데이터를 웹 표로 만들려면 CSV를 HTML로를 사용하세요.
Markdown 표 옵션
| 숫자는 오른쪽, 텍스트는 기본 | 기본값입니다. 비어 있지 않은 모든 값이 일반 숫자인 열만 오른쪽 정렬(---:)하고, 00731이나 12 kg 같은 값이 있으면 렌더러의 기본 정렬을 따릅니다. |
|---|---|
| 기본(지정 안 함), 왼쪽, 가운데, 오른쪽 | 모든 열에 정렬 하나를 적용합니다. 구분 행에 각각 ---, :---, :---:, ---:를 씁니다. |
| <br>로 유지 | 셀 안의 줄 바꿈을 <br>로 바꿉니다. GitHub를 비롯한 대부분의 렌더러가 셀 안의 줄 바꿈으로 표시합니다. 기본값입니다. |
| 공백으로 바꾸기 | HTML을 지우는 렌더러를 위해 줄 바꿈을 공백 하나로 바꿉니다. |
| Markdown 기호 이스케이프 | 기본으로 켜져 있습니다. *, _, [, ], <, >, #, ~, 백틱 앞에 백슬래시를 붙여, *fast*나 <b> 같은 값이 서식이나 HTML로 바뀌지 않고 입력한 그대로 보이게 합니다. 셀에 렌더링하고 싶은 Markdown이 들어 있을 때만 끄세요. |
| 원본 텍스트에서 열 너비 맞추기 | 기본으로 켜져 있습니다. 셀에 공백을 채워 .md 원본 파일도 격자처럼 읽히게 합니다. 한글, 중국어, 일본어처럼 폭이 넓은 문자는 2칸으로 셉니다. 출력을 가장 작게 하려면 끄세요. 렌더링된 표는 똑같습니다. |
파이프, 줄 바꿈, 앞자리 0
- 이스케이프하지 않은
|는 새 셀을 시작하므로, Markdown 기호 이스케이프를 꺼도 파이프와 백슬래시는 항상 이스케이프합니다(\|,\\). - 따옴표 안의 쉼표와 줄 바꿈은 RFC 4180에 따라 읽으므로
"Cable tidy, 3-pack"은 한 셀에 남습니다. 줄 바꿈이 들어 있던 값의 개수는 미리 보기 위의 안내에 표시됩니다. - 값은 텍스트로 씁니다.
00731은 앞자리 0을,34.90은 끝자리 0을 유지합니다. 반올림하거나 형식을 바꾸는 일은 없습니다. - 빈 머리글은
Column 3, 중복된 머리글은name (2)가 되므로 모든 열의 제목이 서로 다릅니다. - Markdown 렌더러는 셀 앞뒤의 공백을 지우며, 표 안에는 목록이나 문단을 넣을 수 없습니다. 그런 내용은 별도 문서에 두세요.
Markdown 표가 제대로 표시되지 않을 때
- 표 뒤의 텍스트가 마지막 행에 붙습니다. 표는 빈 줄이나 다른 블록이 시작될 때만 끝나므로, 표 다음에 빈 줄을 하나 두세요.
- 모든 값이 한 열에 들어 있습니다. 구분 기호를 잘못 추측했습니다. 가져오기 설정에서 쉼표, 세미콜론, 탭, 세로 막대 중 하나를 고르고 파일을 다시 여세요.
- **결과에서 * 나 _ 앞에 백슬래시가 보입니다.** 이스케이프를 무시하는 렌더러에서 이스케이프가 그대로 보이는 것입니다. 보호할 서식 기호가 데이터에 없다면 ‘Markdown 기호 이스케이프’를 끄세요.
- 줄 바꿈이 태그 글자 그대로 보입니다. 렌더러가 HTML을 허용하지 않습니다. ‘셀 안의 줄 바꿈’에서 ‘공백으로 바꾸기’를 고르세요.
한도와 개인정보 보호
25 MB, 10만 행 또는 200만 셀까지의 파일은 처음 200행의 실시간 미리 보기와 함께 열립니다. 더 큰 파일은 스트리밍 방식으로 변환합니다. 파일을 조각 단위로 두 번 읽는데(한 번은 열과 너비 측정, 한 번은 쓰기), 다운로드에 파일 전체가 들어간다는 안내가 표시되고 복사는 제공하지 않습니다. 출력 파일 하나는 최대 4 GB입니다.
변환은 이 탭의 백그라운드 워커에서 실행되므로 페이지가 멈추지 않고, 취소로 중단할 수 있습니다. CSV는 서버로 보내지 않습니다. 큰 파일을 변환하기 전에 확인하려면 CSV 뷰어에서 여세요.
예시: 상품 목록을 Markdown 표로
앞자리 0이 있는 SKU, 이름 안의 파이프, 따옴표 안의 쉼표, 두 줄짜리 메모가 있는 상품 목록을 기본 설정으로 변환한 결과입니다. price는 모든 값이 숫자라서 오른쪽 정렬되고, sku는 00731을 텍스트로 유지하므로 오른쪽 정렬되지 않습니다.
sku,name,price,note 00731,"Desk lamp | brass",34.90,"Ships in 2 days from Leeds" 00732,"Cable tidy, 3-pack white",4.50,Back-ordered until 14 March 2025 00733,USB-C hub,129.00,
| sku | name | price | note | | ----- | ------------------------ | -----: | -------------------------------- | | 00731 | Desk lamp \| brass | 34.90 | Ships in 2 days<br>from Leeds | | 00732 | Cable tidy, 3-pack white | 4.50 | Back-ordered until 14 March 2025 | | 00733 | USB-C hub | 129.00 | |
자주 묻는 질문
결과를 GitHub에서 쓸 수 있나요?
네. GitHub Flavored Markdown의 파이프 표입니다. 머리글 행, 정렬용 콜론을 붙일 수 있는 구분 행, 그리고 CSV 행마다 한 줄로 이루어집니다. GitLab, Obsidian, 대부분의 정적 사이트 생성기도 같은 문법을 읽습니다.
원본에 `\|`가 보이는 이유는 무엇인가요?
Markdown 표에서 그냥 |를 쓰면 셀이 끝납니다. 백슬래시는 렌더러에게 파이프를 텍스트로 보여 주라고 알려 주므로 Desk lamp | brass가 한 셀에 남습니다.
Markdown 표를 CSV로 다시 바꿀 수 있나요?
이 페이지에서는 안 됩니다. CSV와 TSV를 Markdown으로만 변환합니다.