====== Pandoc ======
===== 概要 =====
  * 文書の相互変換プログラム。


===== インストール =====
  * 以下のコマンドでインストールする。\\ <code bash>
$ sudo apt install pandoc
</code>

===== 使用方法 =====
  * markdown (''INPUT.md'') → docx (''OUTPUT.docx'') の変換\\ <code bash>
$ pandoc INPUT.md -o OUTPUT.docx
</code>
    * ''INPUT.md'' を ''OUTPUT.docx'' に変換する。
    * その他のオプション:
      * ''--standalone'': 
      * ''--mathjax'': TeX 数式を MathJax を用いて表示する。
      * ''--citeproc'': 引用文献を処理する。
      * ''--filter'': 変換時に実行するスクリプトを指定する。
      * ''--lua-filter'': 変換時に実行する Lua スクリプトを指定する。
      * ''--highlight-style'': シンタックスハイライトのスタイルを指定する。
  * 特定のスタイルに基づいて、markdown (''INPUT.md'') → docx (''OUTPUT.docx'') の変換\\ <code bash>
$ pandoc --reference-doc REFERENCE.docx INPUT.md -o OUTPUT.docx
</code>
    * ''REFERENCE.docx'' のスタイルに基づいて、''INPUT.md'' から ''OUTPUT.docx'' に変換する。
    * ''REFERENCE.docx'' は以下のコマンドで作成し、word で編集してから使用する。\\ <code bash>
$ pandoc -o REFERENCE.docx --print-default-data-file reference.docx
</code>
    * ''REFERENCE.docx'' 内の特定のスタイルを割り当てる場合、フェンス構文でスタイルを指定する。
      * 例: REFERENCE.docx 内で定義した ''red'' というスタイルを適用する場合 \\ <code>
::: {custom-style="red"}
Red paragraph ...
:::
</code>
        * ただし、本文や first paragraph のみにしか適用できない (見出しやリスト、コードブロックなどの代表的なスタイルは、既定のスタイルが使われるので注意)。
        * 参考サイト: [[https://pandoc-doc-ja.readthedocs.io/ja/latest/users-guide.html#divs-and-spans | Pandoc User’s Guide 日本語版 — 日本Pandocユーザ会]]

===== 関連ツール =====
  * [[ツール/Pandoc/pandoc-crossref]]




{{tag>アプリケーション テキスト}}