Word에서 Markdown로 이미지: 추출, 경로, 대안 텍스트

Word 문서의 텍스트를 Markdown로 변환하는 것은 간단합니다. 이미지를 변환하는 것은 별도의 작업입니다: Word는 미디어에 저장 .docx 패키지, Markdown는 이미지 파일에 대한 텍스트 참조만 저장합니다.

신뢰할 수 있는 워크플로우는 문서 구조를 변환하고 이미지 파일을 추출하고 안정적인 이름을 부여하는 것입니다. 그리고 각각의 이미지를 Markdown에 연결하여 상대적인 경로와 유용한 대안 텍스트를 입력합니다. 이 가이드 는 자산 을 잃지 않고 어떻게 해야 하는지를 알려 줍니다.

짧은 대답

문서가 하나만 있고 사진이 몇 개만 있다면:

변환 .docx 문장 WordToMD.
Word 파일의 복사본에서 이미지를 추출합니다.
이 영상들을 images/ or assets/ 폴더
Markdown 참조를 추가 ![Login settings screen](images/login-settings.png).
최종 Markdown의 목적지에서 미리보기.

많은 문서나 이미지가 임베디드된 경우, Pandoc with --extract-media. It can create the media files and references in one command, although you should still rename, optimize, and review the assets.

사진 과 텍스트 의 행동 이 다른 이유

A .docx 파일은 XML, 관계, 스타일, 미디어를 포함하는 ZIP 패키지입니다. 임베디드 이미지 바이트는 보통 word/media/, 관계 파일은 Word에 각각의 이미지가 표시되는 위치를 알려줍니다. 문서는 또한 작물 지침, 떠 있는 위치, 캡션, 장식 모양, 그리고 직접적인 Markdown 대등을 가지고 있지 않은 링크들이 있습니다.

Markdown 자체는 이미지 바이트를 삽입하지 않습니다. 표준 이미지 문법에는 세 가지 정보가 포함되어 있습니다.

![Alternative text](images/architecture-diagram.png "Optional title")

Alternative text 보이지 않을 때 이미지를 설명합니다.
images/architecture-diagram.png 렌더러에 파일이 어디에 있는지 알려줍니다.
선택적 인 제목은 렌더러에 따라 도구 팁으로 나타날 수 있습니다.

이 분리은 버전 제어와 출판에 유용하지만 완전한 마이그레이션은 .md 파일과 자산

WordToMD가 임베디드 이미지와 무슨 일을 하는지

WordToMD는 제목, 문장, 목록, 링크, 강조, 기본 테이블, 그리고 브라우저에서 지원되는 삽입된 이미지를 변환합니다. 사진이 발견되면, 결과에는 Markdown + 이미지 ZIP 옵션 .md 파일 및 images/ 폴더

문서는 로컬로 남아, 생성 Markdown 이미지 참조는 패키지에 상대적인 경로를 사용 images/ 폴더 Alt 텍스트를 검토하고, 일반 자산의 이름을 변경하고, 복잡한 Word 도사진 객체를 출판하기 전에 확인합니다.

올바른 추출 방법 을 선택 하십시오

방법	가장 좋은	장점	타협
WordToMD Markdown + 이미지 ZIP	지원된 임베디드 이미지가 있는 하나의 문서	설치가 없습니다. 변환 및 이미지 패키지는 브라우저에 남아 있습니다.	복잡한 도표 객체 및 최종 자산 명칭은 검토가 필요할 수 있습니다
DOCX 복사본을 ZIP로 변경	오리지널 임베디드 미디어에 직접 접근	추가 변환기 필요 없	파일 이름: `image1.png` 배치를 설명하지 마십시오
Word에서 웹 페이지로 저장	Word의 인터페이스를 선호하는 사용자	HTML 파일과 미디어 폴더를 생성	생성된 이름 및 HTML은 청소가 필요할 수 있습니다
Pandoc `--extract-media`	많은 이미지, 반복 된 작업 또는 자동화	미디어 추출 및 참조를 자동으로 작성	명령줄 설치 및 검토를 필요로 합니다

작업 흐름 A: WordToMD 플러스 수동 이미지 추출

이 방법은 텍스트 변환을 빠르게 유지하면서 자산 이름과 배치에 대한 통제권을 제공합니다.

1. Markdown를 변환하고 저장

열어요 Word-to-Markdown 변환기, 선택 .docx, 편집할 수 있는 결과를 검토하고, .md 파일이에요 마이그레이션이 완료될 때까지 Word 원본 문서를 변경하지 않고 보관합니다.

2. DOCX의 복사본에서 이미지를 추출

확장자를 변경하기 전에 복사합니다.

윈도우에서:

활성화 파일 이름 확장 파일 익스플로러에서
복사 handbook.docx 작업 폴더로
복사본의 이름을 handbook.zip.
ZIP 아카이브를 추출합니다.
추출된 파일을 열고 word/media/ 폴더

macOS 또는 Linux에서, 일반적인 아카이브 유틸리티는 복사된 .docx 직접, 또는 당신은 파일을 복제하고 확장 변경할 수 있습니다 .zip.

미디어 디렉토리는 PNG, JPEG, GIF, SVG, EMF 또는 WMF 파일을 포함할 수 있습니다. 일부 출판 시스템은 Word에 특화된 벡터 형식을 다루지 않습니다. 그래서 지원되지 않는 형식을 Markdown 프로젝트에 추가하기 전에 SVG 또는 PNG로 변환합니다.

3. 각 파일의 위치와 일치

이름: image1.png and image2.jpeg 패키지 식별자이며, 의미있는 자산 명칭이 아닙니다. 추출된 파일을 니얼로 열고 Word 문서와 비교합니다.

작업하는 동안 간단한 지도를 만들:

Word 위치	추출된 파일	최종 파일 이름
건축 부문	`image3.png`	`system-architecture.png`
로그인 지침	`image7.jpeg`	`login-settings.jpg`
결과 섹션	`image9.png`	`conversion-result.png`

숫자 순서가 항상 시각적 순서와 일치한다고 가정하지 마십시오. 헤더, 반복된 로고, 배경 및 삭제된 콘텐츠는 내부 번호에 영향을 줄 수 있습니다.

4. '기생충' 휴대용 폴더 구조를 생성

간단한 구조는 GitHub, Obsidian, 그리고 대부분의 정적 사이트 생성기에서 작동합니다:

handbook/
├── handbook.md
└── images/
    ├── system-architecture.png
    ├── login-settings.jpg
    └── conversion-result.png

그 다음 상대 경로와 함께 파일을 참조하십시오:

![System architecture](images/system-architecture.png)

상대적 경로는 문서를 휴대할 수 있도록 합니다. 절대적인 경로, 예를 들어 C:\Users\Name\Desktop\image1.png 하나의 컴퓨터에서만 작동하며 Markdown에서 절대 나타나지 않아야 합니다.

5. 의미 있는 대안 텍스트를 작성

Word 이미지 캡션과 Markdown 알트 텍스트는 서로 다른 목적을 제공합니다. 캡션은 가시적인 뒷받침 텍스트이며, 알트 텍스트는 이미지가 전달하는 정보에 대한 간결한 대체입니다.

약자:

![Image](images/image1.png)

더 잘:

![Three-stage publishing flow from Word review to Markdown repository to website deployment](images/publishing-flow.png)

스크린샷을 위해, 관련 인터페이스와 상태를 확인합니다. 그림 을 만들기 위해, 모든 시각적 표지 를 나열 하는 것 보다 결론 을 요약 해 보십시오. 정보를 추가하지 않는 장식적인 이미지에 대해서는 빈 알트 텍스트를 사용하십시오.

![](images/decorative-divider.svg)

word에 대한 주변 문장을 word로 반복하지 마십시오. 가장 명확한 동등한 설명이 아니라면 말이죠.

6. 실제 목적지에서의 미리보기

Markdown 렌더러는 다릅니다. 로컬 에디터에서 작동하는 경로는 배포 후 실패할 수 있습니다.

리포티토리 는 대문자 민감한 파일 이름을 사용합니다.
사이트는 자산 URL을 다시 작성합니다.
Markdown 파일은 다른 디렉토리로 이동합니다.
공간 또는 ASCII 이외의 문자가 다른 방식으로 처리됩니다.
플랫폼이 파일 형식을 차단합니다.

GitHub에서, Obsidian에서 또는 사이트의 일반적인 구축 프로세스를 통해 최종 페이지를 미리보기. 데스크톱과 모바일에서 모든 이미지를 확인하세요.

워크플로우 B: Pandoc로 이미지를 추출

Pandoc는 이미지 매핑이 마이그레이션을 지배할 때 더 적합합니다.

pandoc handbook.docx \
  -t gfm \
  --wrap=none \
  --extract-media=./assets \
  -o handbook.md

Pandoc는 임베디드 미디어를 추출하고 생성된 Markdown에 참조를 작성합니다. 출판하기 전에 생성된 디렉토리를 검사하십시오. 생성된 계층과 이름은 기술적으로 정확하지만 유지하기가 어려울 수 있습니다.

변환 후:

중복 또는 사용하지 않은 자산을 제거합니다.
작은 글씨의 이름으로 파일의 이름을 변경합니다.
이름 변경 후 모든 Markdown 참조를 업데이트합니다.
지원되지 않는 형식을 변환합니다.
대안 텍스트를 추가하거나 개선합니다.
큰 파일을 압축하세요.

반복된 변환에 대해서는 배치 Word-to-Markdown 가이드.

일반적인 목적지 를 위한 이미지 경로

GitHub

Markdown 파일에 대한 이미지 저장 및 경로를 사용:

![Build status screen](docs/images/build-status.png)

파일 이름 사건의 문제입니다. Build-Status.png and build-status.png 리포지토리가 케이스 민감한 시스템에서 렌더링될 때 다른 파일처럼 동작할 수 있습니다. Word-to-GitHub 가이드 GFM 청소의 나머지 부분을 포함합니다.

Obsidian

표준 Markdown 이미지 문법은 여전히 가장 휴대 가능한 선택입니다:

![Research model](attachments/research-model.png)

Obsidian는 또한 위키 스타일의 임베드를 지원하지만, 이는 애플리케이션에 특화되어 있습니다. 모든 참조를 변환하기 전에 휴대성 또는 Obsidian 네이티브 동작이 더 중요하는지 결정하십시오. 참조 Word-to-Obsidian 작업 흐름.

정적 사이트 발전기

사이트는 현재 Markdown 파일에 대한 자산을 풀 수 있습니다. public/ 디렉터리, 또는 수입 파이프라인. 사진을 옮기기 전에 프로젝트의 컨벤션을 확인하세요. 그 경로와 같은 /images/guide/example.png 한 사이트에서 작동할 수 있지만, 사이트가 하위 디렉토리에 배치될 때 끊어질 수 있습니다.

문서를 읽어보세요. Word-static-site 가이드 그리고 생산 빌드 명령을 통해 테스트합니다.

출판 하기 전 에 자산 을 최적화

Word 문서는 종종 표시된 크기보다 훨씬 큰 이미지를 포함합니다. 이러한 원본을 게시하면 가시적인 품질을 향상시키지 않고도 페이지 로딩을 느리게 할 수 있습니다.

다음 의 실용적 인 규칙 을 사용 하십시오.

수출하기 전에 사용되지 않은 부지를 제거합니다.
사진 콘텐츠를 위해 JPEG 또는 WebP를 선호합니다.
뚜렷한 텍스트가 필요한 인터페이스 스크린샷을 위해 PNG를 선호합니다.
호환되는 다이어그램과 로고에 대해 SVG를 선호합니다.
영상 크기를 합리적인 최대 디스플레이 폭으로 변경합니다.
원천이 요구할 때 민감한 메타데이터를 제거합니다.
원래의 고해상도 파일을 공개된 자산 디렉토리에서 벗어나야 합니다.

모든 이미지를 한 형식으로 자동으로 변환하는 것을 피하십시오. 스크린 샷, 다이어그램, 사진, 투명한 일러스트는 서로 다른 요구사항을 가지고 있습니다.

일반적 인 이미지 문제 와 해결 방법

Markdown는 깨진 이미지 아이콘을 보여줍니다

경로와 상대적으로 확인 .md 파일, 대문자 및 확장 포함. 그러면 자산이 배포 출력으로 커밋, 업로드, 또는 복사되었음을 확인합니다.

이미지는 로컬로 작동하지만 온라인에서 작동하지 않습니다

로컬 경로는 프로젝트 외부를 가리키거나, 배포된 사이트는 다른 기본 URL을 사용할 수 있습니다. 기계 특유의 경로를 저장소 관련 또는 사이트 승인 경로로 대체합니다.

추출된 이미지는 Word와 다르게 보입니다.

Word는 작물, 회전, 투명성, 경계, 또는 색조 조절을 하는 것이 기본 이미지 변경이 아닌 문서 지침입니다. 이미지 에디터에서 최종 외관을 재창조하고 출판 준비된 자산을 수출합니다.

다이어그램이 결여되어 있습니다.

스마트아트, 차트, 그룹화된 모양, 그리고 그림 캔버스는 항상 일반 라스터 이미지로 저장되지 않습니다. Word에서 SVG 또는 PNG로 객체를 수출하고, 그 후 수동으로 수출한 파일을 참조합니다.

파일 이름이 변경되었지만 이미지는 사라졌습니다

자산의 이름을 변경하는 것은 Markdown를 자동으로 업데이트하지 않습니다. 프로젝트에서 오래된 이름을 검색하고 참조 형식의 이미지 정의를 포함하여 모든 참조를 업데이트하십시오.

최종 이미지 마이그레이션 체크리스트

FAQ

WordToMD가 내 DOCX의 이미지를 다운로드 할 수 있습니까?

그래요. DOCX를 변환하고 선택 Markdown + 이미지 ZIP. The archive contains the editable Markdown and supported embedded pictures in an images/ 폴더 당신은 또한 원본 미디어 파일만 필요할 때 별도의 Word 이미지 추출기를 사용할 수 있습니다.

Markdown에 이미지를 저장할 수 있나요? `.md` 파일?

표준 Markdown는 바이너리 이미지를 저장하지 않고 참조를 저장합니다. 일부 편집기는 base64 데이터 URL을 받아들이지만 Markdown 파일을 크고 휴대성이 낮게 만듭니다. 상대적인 경로로 별도의 자산 파일을 유지하기는 보통 더 쉽습니다.

절대적인 URL을 사용해야 할까요? 아니면 상대적인 이미지 경로를 사용해야 할까요?

이미지가 동일한 저장소 또는 사이트에 속할 때 상대적인 경로를 사용한다. 이미지를 의도적으로 다른 곳에서 호스팅하고 유지 할 때만 절대 HTTPS URL을 사용합니다. 통제할 수 없는 URL을 피하세요.

Word 캡션을 어떻게 처리해야 할까요?

이미지 근처에서 가시적인 텍스트로 캡처를 유지하고, 이미지의 의미에 대해 별도의 알트 텍스트를 작성하십시오. 출판 시스템에는 그림 또는 캡션 구성 요소가 있다면, 이 쌍을 해당 플랫폼의 지원 문법으로 변환하십시오.

결론

성공적인 Word-to-Markdown 이미지 마이그레이션은 Markdown와 그 자산들을 하나의 패키지로 취급한다. 사용 WordToMD 빠른, 사적인 텍스트 변환을 위해, 매체를 분리하여 추출하고, 의도적인 이름과 경로를 만들 수 있습니다. 그리고 실제로 발표될 장소에서 결과를 미리 보실 수 있습니다. 대규모 또는 반복되는 마이그레이션의 경우 Pandoc로 전환하고 최종 접근성 및 경로 검토를 건너뛰지 않고 추출 단계를 자동화합니다.