Pandocの簡単なお作法的な
入出力
- ファイルが指定されていないとstdin/stdoutに
- ただし
odt,docx,epub,epub3はstdoutに出力されない - ファイルに出力したいときは
-oオプション
フォーマットを明示的に指定
- 入力は
-rか-f - 出力は
-wか-t - 明示しなくても拡張子から推測してくれる
- 不明だと入力がMarkdown、出力がHTMLとして扱われる
対応しているMarkdown
markdown(Pandoc拡張)markdown_strict(オリジナル)markdown_phpextra(PHP Markdwon Extra)markdown_github(Github)
拡張文法の有効/無効
- フォーマットの末尾に+/- 拡張機能
markdown_strict+pipe_tablesだったら- オリジナルmarkdownにパイプテーブル追加
- 実際に使うときは以下な感じ
pandoc -o -t html out.html -f markdown_strict+pipe_tables in.md
オプション例
--toc- 自動的に生成された目次を出力
- 見出しレベル1~3まで目次に含まれる
--toc-depth=x- 目次に含める見出しレベルを指定することができる
--columns=x- 一行あたりの文字数を指定してその文字数で折り返される
Pandoc標準Markdown以外の拡張例
lists_without_preceding_blankline- 段落の後に空行置かずにリスト
hard_line_breaks- 段落内の全ての改行が強制改行に
ignore_line_breaks- 段落内の全ての改行が無視される
autolink_bare_uris- リンクを囲まなくてもリンクに変換
使用例
- 強制改行つけたGithubMarkdownからスタンドアロンなHTML5にcssと目次つける
pandoc -s --toc -c hoge.css -t html5 -o output.html -f markdown_github+hard_line_breaks input.md
