Word 文書のテキストを Markdown に変換することは簡単です. Wordは,画像の内部にメディアを格納します. .docx 画像ファイルへのテキスト参照のみを保存します.
画像ファイルを抽出し 安定した名前を与え 関連パスと有用なアルトテキストで Markdown に接続します このガイドでは 資産の追跡を 失うことなく その方法を示します
短い 答え
文書が1つで画像が数つしかない場合
- 変換する
.docxテキストを表示する WordToMD. - Word ファイルのコピーから画像を抽出します.
- 画像を入力します.
images/orassets/フォルダー - Markdown 参照を追加する
. - 最終 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 ファイルは ZIP パッケージで,XML,関係,スタイル,メディアが含まれています. 画像のバイトは,通常, word/media/それぞれの画像が表示される場所を Word に伝えます. ドキュメントには 割割の指示や 浮き位置や 字幕や 装飾形なども含まれます 直接 Markdown 同等性を持たないリンク.
Markdown自体は画像バイトを埋め込むものではありません. 標準的な画像構文には 3 つの情報が含まれます
Alternative text画像が見えないときに描写しますimages/architecture-diagram.pngレンダーにファイルがどこにあるか 教えてくれます- レンダリング機によって,オプションのタイトルがツールヒントとして表示される場合があります.
完全移行は,バージョン管理と出版の両方を管理しなければならないことを意味しています. .md ファイルとその資産
WordToMD が埋め込み画像に何をしますか?
WordToMDは,ヘッダ,段落,リスト,リンク,強調,基本テーブル,およびブラウザでサポートされている埋め込み画像を変換します. 画像が見つかったら,結果には Markdown +画像 ZIP 選択 .md ファイルと images/ フォルダー
パッケージに相対的なパスを使用します. images/ フォルダー オルトテキストをレビューし,一般的な資産の名前を変更し,複合な Word 図解オブジェクトを公開する前にチェックします.
正しい 抽出 方法 を 選ぶ
| メソッド | 最適な | 利点 | 妥協点 |
|---|---|---|---|
| WordToMD Markdown +画像 ZIP | サポートされている埋め込み画像を含む1つの文書 | インストールなし 変換と画像のパッケージはブラウザに残る | 複雑な図解オブジェクトと最終的な資産命名は,再検討が必要かもしれない |
| DOCX コピーの名前を ZIP に変更する | オリジナル・インベッド・メディアへの直接アクセス | 追加変換は必要ない | ファイル名: image1.png 配置について説明しない |
| Word からウェブページとして保存する | Wordのインターフェイスを好むユーザー | HTML ファイルとメディアフォルダを作成 | 生成された名前と HTML は,クリーンアップが必要かもしれません. |
Pandoc --extract-media | 多くの画像,繰り返す作業,または自動化 | メディアを抽出し,参照を自動的に書き込む | コマンドラインのインストールとレビューが必要 |
ワークフロー A: WordToMD プラス 手動画像抽出
この方法は,テキスト変換を迅速にし,資産名や配置のコントロールを可能にします.
1 について Markdown を変換して保存する
開けろ Word-to-Markdown変換器, 選択する .docx編集可能な結果をレビューし,ダウンロードする. .md ファイル 移行が完了するまで Word 文書の原始を変更しないようにします.
2. 関連性 DOCX のコピーから画像を抽出する
拡張を変更する前にコピーしてください.
Windows では
- 設定する ファイル名拡張子 ファイルエクスプローラーで
- コピー
handbook.docx作業フォルダーに - コピーの名前を変えて
handbook.zip. - ZIPアーカイブを抽出する.
- 抽出したものを開く
word/media/フォルダー
複製したファイルを開くことができます. .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次に,相関パスのファイルを参照します.
相対的な経路は 文書を移植可能にする 絶対的な経路は C:\Users\Name\Desktop\image1.png 単一のコンピュータで動作し, Markdown に掲載されてはならない.
5. 関連性 意味のあるアルトテキストを書く
Word画像のキャプションと Markdownアルトテキストは異なる目的に役立ちます. カプションは可視的なサポートテキストであり,アルトテキストは画像によって伝達される情報の簡潔な代替です.
弱体:
もっといい
スクリーンショットでは,関連するインターフェイスと状態を指定します. グラフ の ため に は,あらゆる 視覚 的 な 特徴 を 列挙 し て いる の で は なく,結論 を 概括 し て ください. 情報を追加しない装飾画像の場合は,空のアルトテキストを使用します.
wordの周囲の字幕 wordを,最も明確な同等な記述でない限り繰り返さないでください.
6 ほか の こと 真の目的地での予告
Markdown レンダーは異なる. ローカルエディターで動作するパスは:
- レポジトリは,大文字に敏感なファイル名を使用します.
- サイトが資産の URL を書き直す
- Markdown ファイルが別のディレクトリに移行します.
- スペースやASCII以外の文字は異なる扱いを受けます.
- プラットフォームがファイル形式をブロックします
GitHub で, Obsidian で,またはサイトの通常のビルドプロセスで最終ページをプレビューします. デスクトップとモバイルで 全ての画像をチェックしてください
ワークフロー B: Pandoc で画像を抽出する
Pandocは,画像マッピングが移行を支配する場合はより適しています.
pandoc handbook.docx \
-t gfm \
--wrap=none \
--extract-media=./assets \
-o handbook.mdPandocは埋め込まれたメディアを抽出し,生成された Markdown に参照を書き込む. 作成された階層と名前が技術的に正しいが維持するのが難しいかもしれません.
変換後:
- 複製または未使用の資産を削除する.
- ファイルの名前を変えて,小文字で記述します.
- 変更した後にすべての Markdown 参照を更新します.
- サポートされていないフォーマットを変換します.
- オルタントテキストを追加または改善する.
- 大きなファイルを圧縮する.
繰り返し変換については, バッチ Word-to-Markdownガイド.
共通目的地 の 画像 経路
GitHub
Markdown ファイルに関する画像を保管し,パスを使用する:
ファイル名 事件の問題だ Build-Status.png and build-status.png リポジトリがケースセンシティブなシステムでレンダリングされたとき,異なるファイルのように振る舞うことができます. について Word-to-GitHubガイド 清掃の残りの部分をカバーします
Obsidian
標準 Markdown 画像構文は,最もポータブルな選択のままです.
Obsidianはウィキスタイルのインベッドもサポートしますが,アプリケーション特有のものです. すべての参照を変換する前に,移植性や Obsidian-ネイティブの行動がより重要かどうかを決定します. 参照 Word-to-Obsidian ワークフロー.
ステティック・サイト・ジェネレーター
サイトは,現在の Markdown ファイルに関連した資産を解決することができます. public/ 輸入パイプラインです 画像を移動する前に プロジェクトのコンベンションを確認します. 経路は /images/guide/example.png サイトをサブディレクトリに 展開するときに サイトが壊れる場合もあります
読み取ってください Word-static-siteガイド 生産ビルドコマンドでテストします
出版する前に アセットを最適化する
Word ドキュメントには,表示されたサイズよりもはるかに大きい画像が含まれています. これらのオリジナルを公開すると ページのロードが遅くなって 視覚的品質が向上しません
実践 的 な ルール を 適用 し て ください
- 輸出前には未使用の土地を収穫する.
- 写真コンテンツの場合は,JPEG または WebP を好む.
- 鋭いテキストが必要なインターフェイススクリーンショットには PNG を好む.
- 対応する図やロゴにSVGを好む.
- 画面の幅を最大限に変更します
- ソースが要求するときに 敏感なメタデータを削除します
- 公開された資産ディレクトリの外にオリジナルの高解像度のファイルを保管します.
すべての画像を1つのフォーマットに自動的に変換しないようにしてください. スクリーンショットや図や写真や透明なイラストには 異なる要件があります
一般 の 画像 問題 と 解決 方法
Markdown は壊れた画像のアイコンを表示します.
経路をチェックする .md ファイル,キャピタライゼーションと拡張を含む. 配備出力に コミット,アップロード,またはコピーされたことを確認します
画像はローカルで動作しますが,オンラインでは動作しません
ローカルパスはプロジェクトの外を指す場合もありますが,デプロイされたサイトは別のベースURLを使用する場合もあります. 機械特有の経路を,リポジトリ関連またはサイト承認の経路に置き換える.
抽出した画像は Word と異なる
Wordは,割割,回転,透明性,境界を適用することができる. 文書の指示として色を調整したり 背景の画像を変えることもできます 画像エディターで最終的な外観を再現し,公開準備のアセットをエクスポートします.
図が欠けている
スマートアート,チャート,グループ化形,画布は,必ずしも通常のラスター画像として保存されません. Word から SVG または PNG としてオブジェクトをエクスポートし,そのエクスポートされたファイルを手動で参照します.
ファイル名が変更されましたが,画像は消えました.
資産の名称変更は Markdown を自動的に更新しません. プロジェクトで古い名前を検索し,参照式画像定義を含むすべての参照を更新します.
最終画像移行チェックリスト
- Markdown ファイルには,対応するアセットフォルダーがあります.
- 情報を伝えるすべての画像は 抽出されました
- ファイル名は記述性があり,安定し,一貫しています.
- 経路は相対的であり,目的地に関する文書化されたコンベンションに従います.
- アルトテキストは意味のある画像の目的を伝達します
- 装飾画像は空のアルトテキストを使用します.
- サポートされていない Word ベクトルフォーマットが変換されました.
- 過剰な資産の規模を 小さくしたり 圧縮したりしました
- マークダウンには ローカルな道路は残っていません
- すべての画像は,モバイルとデスクトップの幅で最終レンダーでチェックされました.
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-to-Markdown画像移行は Markdownとその資産を1つのパッケージとして処理します. 使用する WordToMD メディアを別々に抽出し 意図的な名前や経路を作成します 発表される場所の 予告です 大規模または繰り返される移動の場合 Pandoc に切り替えて,最終アクセシビリティとパスレビューをスキップすることなく,抽出手順を自動化します.