CSV → Markdown 표

PapaParse로 CSV를 파싱한 뒤 GitHub 스타일 Markdown 표로 출력해요 — 헤더 행, 정렬 옵션이 포함된 구분 행, 그 다음 데이터 행 순서. 셀 안의 파이프와 줄 바꿈은 이스케이프하거나 치환해서 GFM 으로 유효한 표가 유지되도록 해요. 셀 내부 공백은 보존됩니다.

자주 만나는 함정

GFM 표에는 처음 사용할 때 헷갈리는 서식 규칙이 몇 가지 있어요.

• 셀 안의 파이프. 셀 안의 `|` 는 GFM 표 파싱을 깨요. 출력은 `\|` 로 이스케이프합니다 — 대부분의 렌더러는 이를 받아들이지만 일부 구형 도구는 그렇지 않을 수 있어요.
• 셀 안의 줄 바꿈. GFM 표는 다중 행 셀을 지원하지 않아요. 셀 내부 줄 바꿈은 단일 공백으로 치환되며, 극단적인 경우 후처리가 필요할 수 있어요.
• 빈 셀. 빈 셀은 빈 셀로 렌더링돼요 (`| |`). 일부 렌더러는 연속된 `|`-`|` 를 더 좁은 컬럼으로 압축하기도 하는데, 이는 렌더러의 선택이지 CSV 쪽 문제가 아니에요.
• 행 길이가 일정하지 않음. 헤더보다 짧은 행은 뒤에 빈 셀이 추가되고, 더 긴 행은 자동으로 잘립니다. 두 경우 모두 상태 라인에 파서 경고가 나와요.
• 0으로 시작하는 ID. 이 도구는 동적 타입 변환을 끄고 있어서 `007` 은 출력에서도 `007` 로 유지돼요. CSV 파서가 원본 문자열을 그대로 보존합니다.
• 잘못된 구분자. PapaParse는 콤마, 탭, 세미콜론, 파이프를 자동 감지해요. 표가 한 컬럼처럼 보인다면 구분자가 감지되지 않은 거예요 — 알려진 정상 소스에서 다시 가져오거나 콤마를 사용하도록 전처리하세요.

탭으로 구분된 입력도 지원하나요?

네 — PapaParse는 TSV, 세미콜론, 파이프, 콤마를 자동 감지해요. Markdown 출력은 항상 파이프로 구분됩니다(GFM 표준).

파이프 정렬(예쁘게 정렬)된 출력을 받을 수 있나요?

아니요 — 출력은 압축성을 위해 단일 공백 패딩을 사용해요. 대부분의 에디터와 Markdown 렌더러는 소스 파일의 컬럼 정렬과 무관하게 표를 동일하게 처리합니다. 소스에 시각적 정렬이 필요하면 에디터의 Markdown 표 서식 플러그인을 사용하세요.

정렬 드롭다운이 왜 모든 컬럼을 동시에 바꾸나요?

컬럼별 정렬은 v1 에 들어가기에는 UI가 더 복잡해요. 현재 컨트롤은 모든 컬럼에 같은 정렬을 적용합니다. 컬럼별 정렬이 필요하면 결과를 복사한 뒤 구분 행을 직접 편집하세요.

얼마나 큰 CSV까지 처리되나요?

약 10 MB까지는 무리 없이 동작해요. Markdown 렌더링에서 매우 큰 표는 드물어요 — 보통 스크롤보다는 페이지네이션을 사용하니까요.

CSV가 어디론가 업로드되나요?

아니요. 모든 처리는 브라우저 안에서 진행돼요. 데이터는 이 페이지의 JavaScript가 파싱하며 어떤 서버에도 전송되지 않습니다.

왜 숫자가 텍스트로 표시되나요?

Markdown 표는 순수 텍스트라 숫자 타입이 없어요. 출력은 항상 문자열로 인코딩됩니다. 렌더러가 CSS로 스타일링할 수는 있지만 소스는 텍스트예요.