문서를 마크다운으로 바꾼 뒤 표·목록·본문을 확인하는 방법

변환 성공 메시지와 내용 보존은 별개입니다

파일을 열어 마크다운을 만들었다고 해서 원본의 모든 정보를 옮긴 것은 아닙니다. 업무 문서라면 제목과 본문의 관계, 수치가 어느 열에 속하는지, 목록의 순서가 유지됐는지부터 확인하세요. 원본과 결과를 나란히 두고 중요한 페이지·시트 한 곳을 먼저 비교하면 전체 검토 기준을 잡기 쉽습니다.

입력	Tooliv의 처리 방식	먼저 볼 부분
PDF	페이지의 텍스트를 위치에 따라 모음	여러 단의 읽기 순서, 표, 빠진 그림
Excel	시트별 데이터를 마크다운 표로 구성	첫 행의 제목, 병합 셀, 값과 표시 형식
DOCX	문서 구조를 HTML로 바꾼 뒤 마크다운 변환	제목 스타일, 목록, 표의 구조
HTML	주요 본문을 골라 마크다운 변환	제거된 영역, 상대 경로 링크·이미지
JSON	코드블록 또는 구조화 테이블	중첩 데이터가 충분히 표현되는지

PDF는 스캔 이미지인지 먼저 확인하세요

Tooliv의 PDF 경로는 PDF.js의 텍스트 추출 기능을 사용합니다. 그림 안의 글자를 읽는 OCR 과정은 없습니다. 화면에는 문자가 보여도 파일에 텍스트 레이어가 없다면 내용을 추출하지 못할 수 있습니다. PDF.js가 제공하는 기능은 공식 API 문서에서 확인할 수 있습니다.

텍스트가 있어도 여러 단으로 편집한 논문이나 표에서는 순서가 달라질 수 있습니다. 예를 들어 왼쪽 단의 첫 줄 뒤에 오른쪽 단의 첫 줄이 붙었다면 문장을 읽기 순서대로 다시 나눠야 합니다. 금액표는 값만 보고 판단하지 말고 열 제목과 행 이름을 함께 확인하세요. 이미지가 필요한 경우 원본 PDF를 보관하고 별도로 첨부해야 합니다.

DOCX의 제목 스타일과 표를 점검하세요

DOCX 변환에 쓰는 Mammoth는 글자의 크기·색을 똑같이 복제하기보다 문서의 의미 구조를 HTML로 옮기는 것을 목표로 합니다. Mammoth 문서는 복잡한 문서 변환이 완벽하지 않을 수 있고, 표 테두리 같은 서식은 무시된다고 설명합니다. Word에서 큰 글씨와 굵기만 준 줄이 제목으로 바뀌지 않았다면 원본의 제목 스타일이나 변환 후 ## 표기를 확인하세요.

DOCX·HTML의 표를 단순한 마크다운 표로 자동 보존한다고 가정해서는 안 됩니다. Turndown 문서는 GFM 표 변환을 확장 기능으로 안내합니다. Tooliv의 해당 변환 경로에서는 복잡한 표를 다시 정리해야 할 수 있습니다. 표가 핵심이라면 열과 행을 확인한 뒤 아래처럼 단순한 형태로 수정하세요.

| 항목 | 수량 | 비고 |
| --- | ---: | --- |
| 케이블 | 2 | A\|B 공용 |

표 머리글 바로 다음에는 열 수가 맞는 구분 행이 필요합니다. 셀 내용의 |는 \|처럼 이스케이프합니다. GFM 표 명세에 따른 문법 예시이며, 병합 셀이나 셀 안의 복잡한 문단까지 같은 형태로 표현하는 예시는 아닙니다.

Excel·JSON은 표시와 데이터의 차이를 확인하세요

Excel은 시트별 첫 행을 표 머리글로 사용합니다. 첫 행이 문서 제목이고 실제 열 이름은 다음 행에 있다면 결과 표도 수동으로 정리해야 합니다. 셀의 색, 열 너비, 병합 구조, 수식 계산 기능을 마크다운 표가 그대로 갖는 것은 아닙니다. 날짜와 소수점이 기대한 표시인지도 원본과 비교하세요.

JSON에 중첩 객체와 배열이 많다면 코드블록 출력을 먼저 선택하세요. 구조화 테이블은 단순한 행·열 데이터에 적합하며, 복잡한 값을 한 셀에 넣는 과정에서 구조를 읽기 어려워질 수 있습니다. MDX 출력은 마크다운에 기본 메타데이터를 붙이는 옵션이며, 문서 전체를 JSX 컴포넌트로 재설계해 주는 기능은 아닙니다.

최종 게시처에서 한 번 더 확인하세요

수정한 결과를 마크다운 → HTML 미리보기에 넣어 제목 단계, 목록 들여쓰기, 표, 링크를 확인하세요. HTML에서 가져온 상대 경로 이미지나 링크는 문서가 놓인 위치가 달라지면 열리지 않을 수 있으니 실제 게시 주소에서도 확인해야 합니다.

원문에 포함한 HTML 일부가 미리보기에서 사라졌다면 허용되지 않는 태그·속성이 제거된 것일 수 있습니다. Tooliv는 문서 변환 미리보기와 마크다운 → HTML의 미리보기·HTML 결과에 DOMPurify를 적용해 위험한 HTML을 제거합니다. 문서 → 마크다운에서 받는 Markdown·MDX 원문 전체를 정화했다는 뜻은 아닙니다. 다운로드한 문서를 다른 게시처에 올릴 때는 그곳의 HTML 처리 기준도 확인하세요.

검토할 때는 “내용이 빠졌는가”, “다른 항목에 붙었는가”, “의미는 같지만 모양만 달라졌는가”를 구분하세요. 필요한 부분을 고친 다음 문서 → 마크다운 변환기의 원본 결과와 비교하면 수정 이유를 추적하기 쉽습니다.