Pandocのサンプル

起動

docker compose build
docker compose up -d

フォーマットの変換

docker compose exec mypython pandoc README.md -o README.html
docker compose exec mypython pandoc README.md -o README.docx
docker compose exec mypython pandoc README.md -o README.pdf --pdf-engine=xelatex -V CJKmainfont="IPAexGothic"
docker compose exec mypython pandoc README_rst.rst -o README.html
docker compose exec mypython pandoc README_rst.rst -o README.docx
docker compose exec mypython pandoc README_rst.rst -o README_rst.pdf --pdf-engine=xelatex -V CJKmainfont="IPAexGothic"

停止

docker compose down

マークアップ言語とは

• プレーンテキストで構造化された文書を作成する
  • wikipediaの定義：文書に注釈を付けるための方法，本文のテキストとは構文的に区別できる
  • 例：HTML（HyperText Markup Language）
  • 多数の言語がある
    • https://en.wikipedia.org/wiki/List_of_markup_languages
• 用途
  • 少しフォーマットをつけて手軽にドキュメントを書きたい
    • コメントに最適
  • 代表例
    • Markdown（拡張子.md）
    • reStructuered Text（拡張子.rst）

Markdownの文法

リスト

• 箇条書き
• こうなります
  • インデントを2つ下げると
  • レベルが上がります
• 箇条書き
  • 箇条書き
    • 箇条書き

コード

コードを入力する場合は以下のようなコードブロックを使います．

def myfunc(a, b, c):
    a = b + c
    print(a)

数式

レンダラによっては$y = f(x)$のようなLaTeX数式も対応しています．インラインだけでなく，行立ての数式 $$ y = \int_a^b f(x, t) dt $$ も対応しています．数式番号は対応していないことがほとんどです（拡張機能が使える場合もある）．