포맷은 대부분의 Word-to-Markdown 변환이 잘못되는 곳입니다. 두꺼운 텍스트는 일반 텍스트로 표시됩니다. 테이블이 무너져요. 제목은 비스타일 된 단락으로 변합니다. 이 안내서에서는 Word를 Markdown으로 변환과 출력을 제어하는 방법.
전환 파이프 라인을 이해 함
Word 문서를 Markdown로 변환하면 두 가지 일이 발생합니다.
- DOCX → HTML mammoth.js는 Word XML을 분석하고 각 요소를 HTML로 매핑합니다.
- HTML → Markdown 턴다운은 HTML을 Markdown 문법으로 변환합니다
두 번째 단계는 HTML이 깨끗하다면 손실이 없습니다. 첫 번째 단계는 Word의 스타일이 알려진 HTML에 해당하는 것을 매핑해야하는 포맷 복잡성이 중요합니다.
사용 WordToMDs 변환기 여러분의 문서가 실시간으로 어떻게 변환되는지 정확히 볼 수 있습니다.
헤드 스타일
Word에서 가장 중요한 포맷 결정은 내장된 헤드 스타일을 사용하는 것입니다.
| Word 스타일 | Markdown 출력 |
|---|---|
| 부문 1 | # Heading |
| 부문 2 | ## Heading |
| 부문 3 | ### Heading |
| 정상 (간장된 텍스트) | **text** (부문 없음) |
일반적 인 실수: 제목 스타일을 적용하지 않고 수동으로 텍스트를 크기와 대자형으로 포맷합니다. 이것은 Word의 헤드처럼 보이지만 Markdown의 담백 텍스트로 변환되지는 않습니다 ##.
전체 항목 참조를 참조하십시오. Markdown 제목 안내서.
본문 의 강조
| Word 포맷 | Markdown 출력 |
|---|---|
| 대담한 | **Bold** |
| 구사문 | *Italic* |
| 대담한 인타릭 | ***Bold Italic*** |
~~Strikethrough~~ | |
| 표기 | (Markdown ekvivalent 없) |
| 부각 | (표준 Markdown 없) |
하이라이트와 하이라이트는 표준 문법에서 Markdown에 해당하지 않습니다. 변환 후 HTML를 사용 <u> 태그나 사용자 정의 CSS 클래스, 만약 출판 플랫폼이 지원한다면.
목록
Word의 자동 리스트 포맷은 깨끗하게 변환합니다:
- Bullet item one
- Bullet item two
- Nested bullet (indent 2 spaces)
1. First item
2. Second item
1. Nested numbered item리스트를 깨는 것: 실제 Word 목록 항목이 아닌 수동으로 입력된 도점이나 숫자. 시각적으로 목록처럼 보이지만 Word는 일반 텍스트 문장처럼 취급합니다. 수정: Word에서 그들을 선택하고 리스트 룰렛 또는 리스트 번호 스타일을 적용합니다.
표
표준 테이블로 변환 GitHub 맛있는 Markdown 테이블 문법:
| Column 1 | Column 2 | Column 3 |
|---|---|---|
| Cell A | Cell B | Cell C |
| Cell D | Cell E | Cell F |어떤 것이 좋은지:
- 합병된 셀 여러 열 또는 행을 포함하는 셀은 붕괴됩니다
- 세포 내부의 라인 틈이 제거됩니다
- 내 테이블은 평평한 텍스트로 평평화
완전한 분할을 보기 위하여, 참조 Markdown 표: 완전한 안내.
코드 및 사전 포맷 된 텍스트
Word에서 모노스페이스 폰트 (Courier New, Consolas) 로 인라인 코드로 포맷된 텍스트:
Use `console.log()` to debug.문법 하이라이트가 있는 울타리 코드 블록의 경우, Words Code 문장 스타일을 적용하여, 만약 여러분의 템플릿에 해당되는 경우, 또는 변환 후 수동으로 세 배의 백티크 펜싱을 추가합니다. 본문 Markdown 코드 블록 가이드 전체 문법입니다.
하이퍼링크
Word 하이퍼링크가 완벽하게 변환:
Visit [WordToMD](https://wordtomd.org) for instant conversion.링크 텍스트와 URL 모두 보존됩니다. 북마크 (동 문서 내의 내부 링크) 는 목표가 Markdown에서 존재하지 않는 경우 변환되지 않을 수 있습니다.
이미지
이미지는 워드에서 마크다운 변환이 지속적으로 부족합니다. mammoth.js는 기본64 데이터 URI로 임베디드 이미지를 추출할 수 있습니다. 하지만 기본 동작은 Conversion Notes에 그들의 존재를 표시하는 것입니다. 변환 후:
- Word에서 이미지를 수출합니다: 파일 → Save As → 웹 페이지 (HTML)
- Markdown에서 참조하십시오:
특별 한 문자 와 상징
Word는 종종 특수 유니코드 문자를 자동으로 삽입합니다:
- 스마트 코팅 (
"...") → 유니코드 문자로 보존 - Em dash (
—) → 보존 - 부러지지 않는 공간 → 정규 공간으로 변환
- 저작권 상징 (
©) → 보존
만약 ASCII만 출력해야 한다면, 변환 후 텍스트 편집기에서 찾아서 교체하세요.
사용자 정의 Word 스타일
만약 당신의 워드 문서가 사용자 지정 된 문장 스타일을 사용한다면 (Callout 또는 Warning과 같이), mammoth.js는 변환 메모로 로그를 기록합니다. 인식되지 않은 문장 스타일: Callout. WordToMD는 이러한 정보 메시지를 기본적으로 필터링합니다.
사용자 정의 스타일을 처리하려면, 사용자 정의 필터로 로컬 Pandoc 설정이 필요합니다. Pandoc Word까지 Markdown 그 접근을 위해서죠.
변환하기 전에 체크리스트를 포맷
변환하기 전에 Word 문서에 이 체크리스트를 적용하세요:
- 모든 제목은 Words를 사용 합니다. 기본 제목 1/2/3 스타일 (손잡이 포맷이 아닙니다)
- 리스트는 Words 리스트 도구로 생성됩니다 (타이핑된 도점/수들이 아닙니다)
- 테이블은 단순한 그리드 (합병된 셀이 없습니다)
- 코드는 모노스페이스 폰트를 사용합니다
- 하이퍼링크는 실제 하이퍼링크입니다 (평색으로 강조된 텍스트가 아닙니다)
FAQ
왜 제 제목이 두꺼운 텍스트로 변환되는 걸까요? 제목 스타일 대신 수동으로 대장 + 글꼴 크기의 형식을 적용했습니다. Word에서, 문장을 클릭하고 스타일 패널을 참조하십시오. 제목 1 은 정상이 아닙니다.
제 번호 목록은 잘못된 위치에 1로 다시 시작되었습니다. 어떻게 수정할 수 있을까요? Word에서 목록 연속을 설정: 오른쪽 클릭을 클릭 → 번호를 계속. 또는 Markdown를 변환 후 바로 편집할 수 있습니다.
테이블 정렬은 Markdown에서 틀린 것 같습니다. 무슨 일이야?
GFM 테이블 사용 |---| 정렬 분리기 WordToMD는 자동으로 생성합니다. 렌더링이 틀린 것 같으면, 틈새 문자를 포함하지 않은 것을 확인합니다 (|) 의 내용 \|.
결론
깨끗 해지기 Word에서 Markdown 포맷 주로 Word를 올바르게 사용하는 것입니다. 내장된 제목 스타일을 적용, Word의 목록 및 테이블 도구를 사용, 당신은 을 얻을 거의 완벽한 출력 WordToMD 변환기. For edge cases — custom styles, complex tables, images — the tips above will get you the rest of the way there.