フォーマットすると,ほとんどの Word-to-Markdown変換が間違っている. 硬い文字は普通文字として表示されます. テーブルが崩壊する タイトルが段落に変わります このガイドは,その間に何が起こるか正確に説明します. WordからMarkdown 変換方法や 輸出制御方法について
変換 パイプライン を 理解 する
Word 文書を Markdown に変換すると,2つのことが起こります.
- 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等価なし は省略) |
| 強調された | (標準 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 段落スタイルを適用します. 変形した後に3重のバックティック・フェンスを 手動で追加します 参照 Markdown コードブロックガイド 完全な文法です.
ハイパーリンク
Word ハイパーリンクが完璧に変換:
Visit [WordToMD](https://wordtomd.org) for instant conversion.リンクテキストとURLは保存されます. ターゲットが Markdown に存在しない場合,ブックマーク (同じ文書内の内部リンク) は変換されない可能性があります.
画像
画像は,Word-to-Markdown変換が一貫して短くなります. mammoth.jsは,組み込み画像を base64 データ URI として抽出できます. しかし,デフォルトの動作は,変換ノートに彼らの存在を注意することです. 変換後:
- Wordから画像を輸出する: ファイル → 保存する → ウェブページ (HTML)
- Markdown で参照する:
特殊 な 文字 と 象徴
Wordは,多くの場合,特別なユニコード文字を自動的に挿入します.
- スマート・オートメント (
"...") → ユニコード文字として保存 - エム・ダッシュ (
—) → 保存されている - 不断空間 → 正規空間に変換
- 著作権シンボル (
©) → 保存されている
変換後,テキストエディターで検索して置き換えてください.
カスタム Word スタイル
変換ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. 変更ノートとしてログインします. WordToMDは,これらの情報メッセージをデフォルトでフィルターします.
カスタム・スタイルを処理するには,カスタム・フィルターを持つローカル Pandoc セットアップが必要です. Pandoc Word から Markdown その方法について
変換する前にチェックリストをフォーマットする
このチェックリストを Word ドキュメントに変換する前に適用してください:
- すべての見出しは Wordを組み込みます 見出し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.