Markdown 표를 Word로: DOCX 내보내기와 열 너비·페이지 조정

셀 단위로 대조할 Markdown 표 준비하기

특징이 다른 몇 개 행으로 시작합니다. 다음 가상의 배포 점검표에는 앞자리 0이 있는 번호, 인라인 명령어, 굵은 글씨, 링크가 들어 있습니다.

# 배포 전 점검

| 점검 번호 | 점검 항목 | 결과 |
| --- | --- | --- |
| 0017 | `npm run build` 실행 | 미확인 |
| 0042 | **설치** 단계 검토 | 재검토 필요 |
| 0090 | [예제 참고 자료](https://example.com/) 열기 | URL 확인 |

열은 3개, 데이터 행은 3개입니다. 머리글을 포함하면 내보낸 표는 4행, 12셀이 되어야 합니다. 링크에는 예시용으로 예약된 도메인을 사용했습니다. 실제 문서에서는 필요한 주소로 바꾸세요.

원문에서는 표의 한 행을 한 줄에 씁니다. 머리글 아래의 하이픈 구분 행이 표임을 나타냅니다. 파이프 기호를 맞추려고 넣은 공백은 원문을 읽기 쉽게 할 뿐 실제 열 너비를 지정하지 않습니다. GitHub의 표 작성 안내에서 문법과 인라인 서식을 확인할 수 있습니다.

편집 가능한 Word 표로 내보내기

1. Markdown을 Word로 변환을 열고 편집기 내용을 위의 예제 1로 바꿉니다. 복사 버튼을 누르면 예제 바깥을 감싼 백틱 세 개짜리 줄을 제외하고 원문만 복사됩니다.
2. 미리보기에서 3열, 데이터 3행, 표 바깥의 제목을 확인합니다. 휴대전화에서는 오른쪽 패널의 Word만 보기 버튼으로 미리보기를 엽니다. 파이프 문자가 그대로 보이면 먼저 원문을 고칩니다.
3. DOCX 다운로드를 눌러 markdown.docx를 저장합니다.
4. Word 또는 호환 편집기에서 파일을 열고 데이터 셀 하나를 수정해 편집할 수 있는지 확인합니다.

예제 영역에서도 예제 1의 Markdown과 DOCX를 받을 수 있습니다. DOCX는 MDFormats 브라우저 도구로 실제 생성한 파일입니다. 아래 이미지는 Microsoft Word가 아닌 브라우저 작업 화면입니다.

미리보기는 구조 문제를 찾는 데 유용합니다. 글꼴, 줄바꿈, 페이지 나누기는 받는 사람이 사용할 앱에서 확인하세요. Pandoc을 포함한 변환 방법 비교는 공개된 Markdown을 Word로 변환하는 안내에 있습니다.

열 너비를 바꾸기 전에 값 대조하기

저장한 파일에서 다음 내용을 확인합니다.

• 0017, npm run build 실행, 미확인이 같은 행에 있어야 합니다. 명령어는 인라인 코드 서식을 유지해야 합니다.
• 0042 행에는 설치 단계 검토와 “재검토 필요”가 함께 있어야 하며, 설치는 굵게 표시되어야 합니다.
• 0090은 참고 자료 및 URL 확인과 같은 행에 있어야 하고, 링크 대상은 https://example.com/이어야 합니다.
• 번호 앞의 0을 유지해야 합니다. 빈칸, 0, 아직 확인하지 않음은 다른 뜻이므로 누락된 값의 의미를 밝혀 둡니다.

긴 표는 첫 페이지 이후까지 모든 행을 비교합니다. 행 위치에만 의존하지 말고 고정된 식별 번호를 사용하세요. 나중에 표를 둘로 나누더라도 양쪽에 같은 번호를 남겨야 대응 관계를 알 수 있습니다.

열 밀림과 값 누락을 일으키는 원문 고치기

Word에서 모양을 다듬기 전에 원문 구조를 수정합니다. 그렇지 않으면 다시 내보낼 때 같은 문제가 생길 수 있습니다.

증상	확인할 부분	먼저 할 일
파이프가 일반 문자로 보임	구분 행 누락 또는 표 전체를 감싼 코드 펜스	구분 행을 복구하고 가장 바깥의 표시용 펜스만 제거
값이 다음 열로 밀림	셀 안 파이프 또는 행마다 다른 셀 수	머리글과 해당 행을 대조
표가 중간에서 끝남	표 안의 빈 줄 또는 새로운 블록	행을 연속으로 쓰고 설명은 아래로 이동
미리보기는 정돈됐지만 값이 없음	원문 행의 셀이 많거나 적음	원래 값과 비교하고 해당 행 재작성

다음 예제는 의도적으로 구분 행을 뺐습니다.

| 점검 번호 | 점검 항목 | 결과 |
| 0017 | 빌드 실행 | 미확인 |

두 줄 사이에 | --- | --- | --- |를 넣고 각 행을 3셀로 유지합니다. GFM 표 명세에서는 머리글과 구분 행의 열 수가 일치해야 합니다. 데이터 행에서 부족한 셀은 빈칸이 되고 초과한 셀은 무시되므로, 중요한 자료를 자동 보정에 맡기지 마세요.

셀 안에 파이프 자체를 쓰려면 이스케이프해야 합니다. GFM에서 아래 첫 번째 셀은 A|B를 나타냅니다.

| 규칙 | 의미 |
| --- | --- |
| A\|B | 둘 중 하나 |

실제로 사용할 경로로 내보내 확인합니다. 미리보기와 DOCX 변환기가 지원하는 문법은 다를 수 있습니다. 여전히 나뉜다면 Markdown 셀의 식을 임시로 RULE_TEXT로 바꾸고 다시 내보내 행이 2셀인지 확인합니다. 그런 다음 Word 첫 번째 셀에서 RULE_TEXT를 정확한 A|B로 바꿉니다. 코드라면 문자를 바꾸지 않고 표 밖으로 옮길 수도 있습니다.

너비가 넓은 표를 Word 페이지에 맞추기

다음 원문은 6열입니다. 웹에서는 가로로 스크롤할 수 있지만 세로 방향 문서에서는 비좁을 수 있습니다.

| 점검 번호 | 구성 요소 | 환경 | 담당 | 근거 | 다음 작업 |
| --- | --- | --- | --- | --- | --- |
| 0017 | 설치 프로그램 | 데스크톱 | 배포팀 | 빌드 로그 | 명령어 출력 검토 |
| 0042 | 안내서 | 문서 | 문서팀 | 검토 기록 | 설치 단계 확인 |

먼저 반복되는 머리글을 줄이고, 링크에 알아보기 쉬운 이름을 붙이며, 긴 설명은 문단으로 옮깁니다. 6열을 동시에 볼 필요가 없다면 점검 번호를 양쪽에 남긴 채 두 개의 작은 표로 나눕니다.

표를 나눌 수 없다면 Word에서 표를 선택한 뒤 표 레이아웃 → 자동 맞춤을 열고, 표 전체를 창 너비에 맞추는 항목을 선택하세요. 그 뒤 설명 열은 넓게, 짧은 번호 열은 좁게 조정합니다. Microsoft의 표 크기 조정 안내는 창에 맞추기와 내용에 맞추기를 구분합니다. 어느 쪽이든 결과를 살펴보세요.

정렬은 따로 확인해야 합니다. Markdown의 :---, :---:, ---:는 왼쪽, 가운데, 오른쪽 정렬을 나타내지만 모든 DOCX 경로에서 같은 배치를 보장하지는 않습니다. 특히 금액과 번호는 필요한 정렬을 Word 셀에 지정하세요. 공백으로 위치를 밀지 않습니다.

이 작업 화면에는 DOCX 용지 방향이나 개별 열 너비 설정이 없습니다. 가로 방향 구역이 필요하면 Word에서 설정하고 앞뒤 페이지도 점검합니다. 편집 없이 읽기만 할 문서라면 Markdown을 PDF로 변환에서 용지와 방향을 선택할 수도 있습니다. 저장한 PDF는 따로 확인하세요.

여러 페이지에 걸친 표의 머리글과 행 확인하기

표가 다음 페이지로 이어질 때 머리글을 반복하면 각 열의 의미를 알기 쉽습니다. 데스크톱 Word에서 표의 첫 번째 행을 포함해 머리글을 선택한 뒤, 테이블 레이아웃의 머리글 행 반복을 사용합니다. Microsoft의 머리글 반복 안내에 따르면 반복 머리글은 인쇄 모양 또는 인쇄 시 표시되며, 표 안에 수동 페이지 나누기를 넣은 위치에서는 반복되지 않습니다.

한 행이 두 페이지로 나뉘면 표를 마우스 오른쪽 버튼으로 클릭해 속성을 열고, 행 설정에서 페이지 간 나누기 옵션을 확인하세요. Microsoft의 표 속성 안내(영문)를 참고할 수 있습니다. 행을 나누지 않으면 행 전체가 다음 페이지로 이동할 수 있습니다. 셀 하나의 설명이 너무 길다면 문서 전체를 작게 만들기보다 설명을 표 아래로 옮깁니다. Word 버전에 따라 명칭과 사용 가능한 옵션이 다릅니다.

수정 후 첫 페이지, 중간, 마지막 페이지를 확인하세요. 이 설정은 Word에서 조정하는 것이며 MDFormats가 자동 적용하는 옵션은 아닙니다.

복잡한 구조가 필요한 셀 단순하게 만들기

여기서 사용하는 GFM 표에는 텍스트, 굵은 글씨, 링크, 짧은 코드를 넣을 수 있습니다. 다만 셀을 병합하는 문법은 없으며, 셀 안에 또 다른 표나 여러 문단의 목록을 넣는 구조도 지원하지 않습니다. 두 열 위에 병합된 '담당' 머리글이 있다면 '현재 담당'과 '다음 담당'처럼 열 이름을 명확히 하세요. 필요한 병합 레이아웃은 나중에 Word에서 만듭니다.

HTML을 추가해도 DOCX에 같은 레이아웃이 생긴다고 가정하지 마세요. 이 경로의 Word 파일에는 참조 이미지가 포함되지 않습니다. 필요한 이미지는 Word에서 추가하고 표 배치에 미치는 영향을 다시 확인합니다.

자주 묻는 질문

Markdown 표를 Word에 바로 붙여넣을 수 있나요?

문자로 붙여넣을 수는 있지만 Word가 파이프를 표 문법으로 해석한다고 가정하면 안 됩니다. 이미 렌더링된 표가 있다면 붙여넣고 셀을 편집할 수 있는지 확인하세요. 원문만 있다면 DOCX 내보내기나 Markdown을 지원하는 변환 경로를 사용합니다.

원문과 Word의 열 너비가 다른 이유는 무엇인가요?

파이프 주변 공백은 문서의 실제 치수를 정하지 않습니다. 미리보기 너비, 여백, 글꼴, 열 너비 설정이 줄바꿈에 영향을 줍니다. Word에서 표를 조정해도 Markdown 원문은 바뀌지 않습니다.

셀을 병합하거나 긴 목록을 넣을 수 있나요?

GFM 파이프 표 문법의 범위 밖입니다. 셀에는 짧은 참조만 두고 설명은 아래로 옮기거나, Word에서 복잡한 구조를 만드세요.

미리보기가 맞으면 모든 값이 보존된 건가요?

아닙니다. 다운로드한 파일과 원문을 대조해 번호, 행별 대응, 링크, 마지막 행까지 확인해야 합니다. 정돈된 표에도 밀리거나 빠진 값이 있을 수 있습니다.

편집하고 대조할 수 있는 표로 마무리하기

Markdown 표를 Word로 옮길 때는 내용을 먼저, 페이지 배치를 나중에 확인합니다. Markdown을 Word로 변환에서 예제의 12셀을 대조한 뒤 실제 사용할 편집기에서 열 너비와 페이지 나누기를 조정하세요. 나중에 수정하려고 .md 원문을 따로 저장하는 것은 선택 사항입니다.