nature-paper2word

Markdown → 準拠した Word

このファイルはルーターです。エンジンは決定論的です。同じ原稿と同じ書式要件を使えば、常にバイト単位で同一の .docx が生成されます。手書きの python-docx スクリプトで代用せず、インストール済みのパイプラインを実行してください。

セッション中に初めてエクスポートする前に、エンジンが使用可能であることを確認してください：md-to-word --version を実行すると、バージョンが表示されます。このスキルにはドキュメントのみが含まれています。コマンドが見つからない場合は、pip install md-to-word-docx でインストールしてから、もう一度確認してください。

用語の完全な一覧はここではなく、パッケージ内のマニュアルに記載されています。md-to-word --contract はその絶対パスを表示します（原稿に合わせて中国語または英語で表示されます）。以下はすべて作業手順です。表記はすべてマニュアルで確認してください。

1. 最初にシナリオを決める

シナリオ	ユーザーの依頼	対応方法
学術誌または学校の書式要件	「Nature／所属大学の書式にして」	対象の .docx テンプレートまたは書面による仕様を入手し、要件ファイルを作成します。
既存の要件	「研究室の仕様ファイルを使って」	-r を付けて指定します。
基本エクスポート（仕様の明示なし）	「これを Word ファイルにして」	原稿を契約仕様に合わせて正規化してから、組み込みプリセットでエクスポートします。プリセットは完全かつ有効な書式であり、暫定的なデフォルトではありません。

選択したプリセットまたは要件ファイルのパスを1行で示してから、作業を進めてください。-r を指定しない場合、読み込まれるのは原稿と同じ場所にあり、名前が正確に format.txt であるファイルだけです。他の .txt ファイルが推測で選ばれることはありません（該当するファイルがある場合は、実行時にリマインダーでその名前が示されます）。format.txt がない場合、プリセットは原稿の言語に従います：中国語の場合は zh-academic、それ以外の場合は en-nature です。実行時に使用したプリセットが報告されます。

パスを指定するだけで任意の Markdown を受け取り、完成した文書を返すことはできません。プリセットが提供するのは書式であり、不足している構成ではありません。原稿が契約仕様に違反している場合、プリフライトで行番号を示して停止します。書式が対応付けられていないのに、見た目だけ整った文書を生成することはありません。

2. 原稿を入力仕様に合わせる

ソースには、貼り付けたテキスト、.txt、.md、古い.docx、PDFを使用できます。まずMarkdownに正規化してください。ユーザーの元ファイルを直接編集しないでください。

• 見出し：#、##、###を連続して使用し、レベルを飛ばさないでください。見出し自体に番号（1.、2.1など）が付いている場合は、番号の階層数と同じ数の#が必要です。
• 段落スタイル：%% で始まる行は、その段落のスタイルを指定します。 %% Abstract …、%% Table Caption **Table 1** …、%% Image Caption Figure 1 …のように記述します。 1行が1段落で、空行で終わります。閉じフェンスは付けません。スタイル名には、どちらの言語でも固定リスト（マニュアル§3.4）の項目を使用します。見出しレベルは#のみで指定します。
• タイトル、著者、要旨、キーワードは、YAMLではなく本文のスタイル行として記述します。ページ上の位置は著者が決めるものであり、YAMLには位置を指定する方法がありません。Pre-flightでは、これらのキーをブロックし、代わりに記述する正確な行を提示します。
• 段落：1行が1段落です。連続する行が結合されることはないため、短い1文の段落が並ぶファイルは、そのままで正しい形式です。同じ段落内で改行する場合（住所、詩、長いタイトルなど）は、行末にバックスラッシュまたは半角スペースを2つ付けてください。これにより、同じ段落内の改行になります。折り返しの可能性がある箇所は、行番号付きの警告としてまとめて報告されます。
• YAMLに記述できるのは、位置に依存しない設定のみです：bibliography:、csl:、crossref:、link-citations:。
• 数式：独立した行に$$...$$ {#eq-name}と記述し、@eq-nameで参照します。中国語の原稿では接頭辞に「式／図／表」を付け、番号は（1）の形式になります。英語の原稿ではEquation／Figure／Tableを使用し、番号は(1)の形式になります。章ごとに番号を付けるには、crossref: chapters: trueを追加します。\tag{}はブロックされます。
• 引用：括弧付き引用には[@key]、本文中の引用には@keyを使用し、bibliography:とcsl:を指定します。原稿で引用を使用する場合は、.bibファイルが必須です。手書きの参考文献一覧には対応していません。また、bibliography:がない状態で[@key]を記述すると、文字列がそのまま出力されます。
• 図と表：![](path/img.png){width=13cm}のように記述し、キャプションは独立した%% Image Caption／%% 图片题注段落に記述します。表のキャプションは表の上、注記は下に配置します。画像に{#fig-...}ラベルを付けないでください。列幅は区切り行のダッシュの長さに従います。
• ブロックマーカー（3種類。各マーカーを独立した行に記述し、前後に空行を入れます）：{{< pagebreak >}}、{{< toc >}}、{{< section page_number=lowerRoman start=1 >}}（中国語のパラメーター页码=、起始=も使用できます）。セクションマーカーは直前のセクションを閉じます。その隣にページ区切りを追加しないでください。
• 未対応のMarkdownは、そのまま出力されず、代替表現に置き換えるようブロックされます：HTMLタグ、---の水平線、====の見出し、定義リスト、- [ ]形式のチェックボックス、外側のパイプがない表、ネストした引用、全角の％％、4つのスペースによるコードブロック、リスト項目内の2つ目の段落、==highlight==、[text]{.class}（.underlineを除く）、インライン数式の\(...\)、パーセント指定の画像幅（{width=60%}。絶対長で記述してください）。

3. 書式要件を選択または作成する

0. 何もない状態から始める — md-to-word init を実行すると、プリセットの完全なコピーと、そのままエクスポートできる1ページの原稿が作成されます。
1. 組み込みプリセット — zh-academic または en-nature。ユーザーから詳しい仕様が指定されていない場合は、そのまま使用します。
2. プリセットをコピーして編集する — ユーザーが指定した行だけを変更します。項目の順序は固定です：フォント、サイズ、太字、斜体、配置、行間、前の間隔、後の間隔、インデント。各スタイル行にはすべての項目を記載する必要があります。項目が抜けているとエラーになります。
3. 対象の .docx をリバースエンジニアリングする — md-to-word-template target.docx -o format.txt を実行し、下書きの末尾にある「要確認」リストを確認します。

各プロパティで受け付ける表記は厳密に決まっています（全体で2種類：中国語の正式表記と英語の正式表記）。それ以外の表記は、行番号付きのエラーになります。完全な表はマニュアル §3.1 を参照してください。スタイル名は §3.4 を参照してください。プリセットが参照例です。md-to-word --contract を実行すると、そのパスが表示されます。

このファイル全体を通じて、format.txt は書式要件ファイルを指します。任意のパスを使用でき、-r で指定します。

引用スタイルは、同梱ファイル名（マニュアル §7）またはユーザー独自の CSL ファイルへのパスを指定する csl: で設定します。csl: がない場合、中国語の原稿には GB/T 7714 数値形式、それ以外には APA 7th が適用されます。ユーザー指定の CSL はエクスポート時に正規化されるため、1つの要件ファイルから常に同じレイアウトが生成されます。

4. エクスポートする

原稿のディレクトリから、インストール済みのコマンドを実行します。

md-to-word manuscript.md -o manuscript.docx
md-to-word manuscript.md -r format.txt -o manuscript.docx
md-to-word --contract          # contract + paths to the manual and presets

パイプラインでは、事前検証 → スタイルテンプレート生成 → 原稿モデル作成 → OOXML 書き込み → 番号の整合性チェック → 要件ファイルとの行単位の照合が実行されます。

5. ゲートの読み方

誤りが後から見てわかるかどうかによって、2つのレベルに分かれます。

• ブロッキング — 後から気づかないまま誤った状態になるものです。コンテンツの脱落、構文がそのまま印字される、書式がまったく反映されない、YAML 内のタイトル、画像の角括弧内にあるキャプションなどが該当します。報告された行を修正してください。ブロッキングゲートも無効にする --no-check は使用しないでください。
• 警告 — 目に見えるものの、要件に準拠していない状態です。テキスト領域より幅の広い画像（幅が制限されます）、図から離れたキャプション、見出しレベルの飛び越し、セクションマーカーの後の改ページ、行の折り返しの疑いなどが該当します。同じ種類の警告は1行にまとめられます（最大8個の行番号が表示され、それを超える場合は件数が表示されます）。

結果をプログラムで読み取る必要がある場合は --json を追加します。標準出力には ok、returncode、input、output、pdf、lang、messages、errors を含む1つの JSON オブジェクトが出力され、進行状況とリマインダーは標準エラー出力に表示されます。キーは固定ですが、その中の文言は原稿の言語に従い、リマインダーは messages に含まれます。

終了コード：0 はすべてのゲートを通過、1 は原稿、ゲート、または依存関係の問題、2 は使用方法のエラー（無効なフラグまたは引数の不足）、3 は .docx が書き出されたものの、オプションの --pdf による確認用出力がスキップされた場合（macOS 以外）です。メッセージは原稿の言語に従います。書式が反映されていないように見える場合は --verbose を追加してください。

6. 提出前に確認する

• .docx が存在し、コマンドが 0 で終了したことを確認します。
• 適用したプリセットまたは要件ファイル、引用スタイル、実行時に警告された内容を報告します。
• Word でレイアウトを手動確認する必要があることを明確に伝えます。エンジンが検証するのはテキストと構造です。行の高さ、列幅、数式やキャプションの配置は、実際のレンダラーでしか確認できません。
• 文書に目次、{style-title} ヘッダー、またはセクションごとのページ番号がある場合は、--pdf を付けて一度実行します（macOS と Word が必要）。フィールドを展開するにはこれが唯一の方法です。そのうえで、最初のページ、最も幅の広い表、数式の多いページ、参考文献を抜き取り確認します。

7. 制限事項

• カスタム表紙、セルの結合、複数段組みのテキスト、インラインの文字色、テキストを回り込ませた図には対応していません。本文をエクスポートしてから、Word で仕上げてください。
• 相互参照に対応しているのは数式のみです（{#eq-x} + @eq-x）。図と表の番号はキャプションに入力してください。
• 番号付き数式では、総和記号と積分記号の上下限は記号の右側に配置されます（Word ではディスプレイ数式の場合のみ上下に配置されます）。内容と記号は正しく、配置のみが異なります。
• 目次のページ番号と章見出しは Word のフィールドです。Word で更新するかどうかを尋ねるメッセージが一度表示されます。 詳細はマニュアルの§6（上下限）および§8（症状 → 修正）を参照してください。

8. 関連スキル

このスキルは原稿をコンパイルします。以下のスキルはその前後の手順を担当します。再実装せず、適切に引き継いでください。

スキル	対応内容
nature-writing	原稿とセクション単位の論旨の作成（このスキルへの入力）
nature-polishing	言語の推敲と学術的な表現（このスキルへの入力）
nature-citation	参考文献項目の検索とエクスポート（RIS / ENW / Zotero RDF）。このスキルが使用する .bib ファイル用に、文献管理ソフトから BibTeX をエクスポート
nature-ref-verifier	投稿前の参考文献メタデータの照合
nature-paper2ppt	同じ原稿からプレゼンテーション資料を作成

上流のエンジン、汎用 pip パッケージ、および変更履歴： md-to-word。