DOCX 마크다운 변환

Q: 워드 문서의 그림은 어디로 갑니까?

**이미지 포함**을 켜면 그림마다 ZIP 안에 별도 파일로 저장되고, 마크다운은 `images/figure-1.png` 같은 상대 경로로 이를 연결합니다. 옮길 때는 폴더를 .md 파일 옆에 그대로 두십시오.

Q: 워드 각주가 마크다운에서도 유지됩니까?

CommonMark에는 각주 문법이 없지만 GitHub가 2021년에 `[^1]` 각주를 추가했고 대부분의 사이트 생성기도 지원합니다. 렌더러가 지원하지 않으면 주석 텍스트가 끝부분에 일반 문단으로 나타납니다.

Q: 이 방법으로 Google Docs도 마크다운으로 바꿀 수 있습니까?

가능합니다. Google Docs에서 **파일 > 다운로드 > Microsoft Word(.docx)**를 고른 다음 그 파일을 여기에 업로드하십시오. Google Docs에도 자체 마크다운 다운로드 옵션이 있으며 단순한 문서에는 잘 맞습니다.

문서를 워드에서 Git 저장소로 옮기는 첫 단계는 .docx를 하나하나 마크다운으로 바꾸는 것입니다. 이 변환기는 # 제목, 파이프 표, 이미지 링크가 들어간 CommonMark 방식 텍스트를 써서 바로 커밋할 수 있게 해 줍니다.

또는 PDF, DOC, DOCX … 파일을 여기에 끌어다 놓으세요 ·

파일당 최대 95 MB· 최대 20개 파일· 30분 뒤 삭제

출력

변환할 형식

서식

파일은 UltKit 서버에서 처리되며 30분 뒤 삭제됩니다.

사용 방법

1
워드 파일 업로드
.docx나 .doc 파일을 최대 20개, 파일당 95 MB까지 추가합니다. 마크다운은 변경 내용 추적을 표시할 방법이 없으므로 먼저 워드에서 적용하거나 거부하십시오.
2
텍스트 옵션 확인
서식은 간단히, 텍스트 인코딩은 UTF-8, 줄 바꿈 방식은 LF로 되어 있으며, Git과 정적 사이트 생성기가 기대하는 조합입니다. 그림을 폴더로 받으려면 이미지 포함을 켜 두십시오.
3
변환 후 압축 풀기
MD로 변환을 누르십시오. 각 문서가 .md 파일과 이미지가 담긴 ZIP으로 도착하며, 문서 폴더에 압축을 풀고 커밋하면 됩니다.

답변

워드 문서를 마크다운으로 변환하려면 어떻게 합니까?

.docx를 업로드하고 MD로 변환을 누르십시오. # 제목, 목록, 링크, 표가 들어간 .md 파일과 그 옆 폴더의 이미지가 ZIP 하나에 담겨 나옵니다.

docs-as-code를 위한 DOCX 마크다운 변환

팀이 docs-as-code를 도입하는 이유는 하나입니다. 문서가 코드 옆에 있고, 같은 풀 리퀘스트를 거치고, 같은 릴리스로 배포되기 때문입니다. .docx는 이 흐름을 깹니다. Git이 불투명한 바이너리로 저장하는 XML 부분의 ZIP이기 때문입니다. 단어 하나만 바꿔도 읽을 수 있는 diff 없이 파일이 바뀌었다고만 표시되고, 두 사람이 동시에 편집하면 작업을 병합할 수 없습니다.

마크다운은 일반 텍스트라서 모든 편집이 눈에 보이는 줄 변경입니다. 2014년 John MacFarlane 등이 Gruber가 10년 전 느슨하게 설명한 문법을 정밀하게 정의한 CommonMark를 발표하면서 훨씬 예측 가능해졌습니다. GitHub는 2017년 CommonMark를 바탕으로 자체 GitHub Flavored Markdown 규격을 만들고, 오늘날 대부분의 README가 쓰는 파이프 표, 작업 목록, 취소선을 더했습니다.

반대로 워드로 작업하는 검토자에게 마크다운을 보내야 한다면 마크다운 DOCX 변환을 이용하십시오. 저장소가 아니라 웹 페이지용이라면 DOCX HTML 변환이 스타일을 더 많이 유지합니다.

마크다운 출력 예시

제목, 목록, 표가 있는 워드 섹션을 변환한 결과

## 릴리스 체크리스트

릴리스 태그를 달기 전에 다음을 확인하십시오.

- **main**에서 테스트 통과
- 변경 로그에 병합된 PR이 모두 기재됨

| 단계 | 담당 |
| --- | --- |
| 빌드 | CI |
| 배포 | 메인테이너 |

![릴리스 흐름](images/figure-1.png)

변환한 마크다운이 렌더링되는 곳

마크다운 파일을 바로 읽는 플랫폼
기관	요구 사항	출처
GitHub	저장소의 README.md와 모든 .md 파일을 GitHub Flavored Markdown으로 렌더링	github.com
Hugo	CommonMark 호환 파서로 .md 콘텐츠 파일에서 페이지를 빌드	gohugo.io
Jekyll	front matter가 있는 .md 파일을 페이지로 변환, GitHub Pages의 엔진	jekyllrb.com
Docusaurus	docs 폴더의 .md와 .mdx 파일을 문서 페이지로 읽음	docusaurus.io

DOCX

Microsoft Word 문서

DOCX는 Office 2007부터 Microsoft Word의 기본 문서 형식으로, Office Open XML 표준(ECMA-376, ISO/IEC 29500)을 기반으로 합니다. 텍스트, 스타일, 이미지, 표, 메모, 변경 내용 추적을 담은 XML 파일들을 ZIP 패키지로 묶은 구조입니다. 회사, 학교, 입사 지원에서 편집 가능한 문서로 가장 흔히 쓰이는 형식입니다. Word, Google Docs, LibreOffice, Pages 사이에서는 특히 복잡한 서식일수록 레이아웃이 조금씩 달라질 수 있습니다. 대부분의 워드 프로세서가 DOCX 파일을 엽니다.

압축 방식: –
투명도: –
애니메이션: –
도입 연도: 2007 · Microsoft

DOCX 변환

MD

마크다운(Markdown)

Markdown은 2004년 John Gruber가 만든 가벼운 마크업 문법입니다. 제목은 #, 강조는 *, 목록은 -처럼 일반 텍스트 기호를 사용하므로 원문 그대로도 읽기 쉽고 HTML로 깔끔하게 변환됩니다. README 파일, 기술 문서, 위키, 메모 앱, 많은 정적 사이트 생성기의 표준입니다. CommonMark, GitHub Flavored Markdown 같은 여러 방언이 있으며 표 같은 세부 문법이 조금씩 다릅니다. .md 파일은 어떤 텍스트 편집기로도 열 수 있습니다.

압축 방식: –
투명도: –
애니메이션: –
도입 연도: 2004 · John Gruber

MD 변환

문서가 코드 작업 흐름으로 들어갈 때 DOCX를 마크다운으로 변환합니다. README, 문서 사이트, Git으로 관리하는 지식 베이스처럼 일반 텍스트로 차이를 비교하고, 풀 리퀘스트에서 검토하고, 여러 도구로 렌더링하는 곳입니다.

마크다운에 대응하는 것이 없는 워드 기능

변환 전에 대비할 점

글꼴, 색상, 페이지 레이아웃은 빠집니다. 마크다운은 구조를 기술하고, 모양은 사이트 테마가 정합니다
변경 내용 추적과 메모는 옮겨지지 않으므로 먼저 워드에서 정리하십시오
머리글, 바닥글, 페이지 번호는 .md 파일에 들어갈 자리가 없습니다
텍스트 상자와 텍스트 배치된 이미지는 일반 문단과 이미지 링크가 됩니다
제목 2 대신 굵게 16 pt처럼 손으로 서식을 지정한 제목은 굵은 텍스트로 나오므로 먼저 진짜 제목 스타일을 적용하십시오
밑줄은 마크다운 문법이 없어 제거되거나 HTML로 남습니다