Pandoc勉強会資料

自己紹介

自己紹介情報

本日のテーマ

  • Pandocの紹介
  • 自身の雑開発物紹介

目次

  1. Pandocとは
  2. Pandocの使い方
  3. Pandocを使ってできる事
  4. Pandocを使った自己開発物の紹介

Pandocとは

概要

  • Pandocは、異なるドキュメント形式間で変換を行うユニバーサルなドキュメントコンバータです。
  • 対応形式: Markdown, HTML, LaTeX, PDF, Word, ePub, PowerPoint (pptx) など多数。
  • Haskell製

特徴

  • クロスプラットフォーム対応。
  • 拡張可能で柔軟性が高い。
  • オープンソースで無料。

利活用例

  • Markdownで作成したドキュメントをPDFやPowerPointに変換。
  • 複数の形式に対応するプレゼンテーション資料の作成。
  • 社内テンプレート等を利用した資料作成をGit管理で行うことができる

Pandocの使い方

インストール

  • 公式サイト: 公式サイトからダウンロード。
  • パッケージマネージャーを使用してインストール。

コマンド例

基本コマンド

Markdown 2 PowerPoint

  • コマンド:

    pandoc input.md -o output.pptx

オプション例

  • -s: スタンドアロンモード。
    • ファイル単体で使える形になる
  • --reference-doc: テンプレートファイル (例: potx) の指定。
    • 独自に作成したテンプレートを使用できる

potxを使用した例

  • コマンド:

    pandoc input.md -o output.pptx --reference-doc template.potx

    ※注意点 Pandocで使用できる形へ整えてあげないとうまく動いてくれない事が多々ある

Pandocを使ってできる事

ドキュメントのmd管理

  • 異なる形式のドキュメントを一つのソース (例: Markdown) で管理。
  • 複数形式への一括出力が可能。
  • 社内テンプレート等に沿ったpptxへの変換が可能

プレゼンテーション資料の作成

  • MarkdownからPowerPoint資料 (pptx) の生成。

  • reveal.jsを使用したWebベースのスライド作成も可能。

    pandoc slides.md -t revealjs -o slides.html

PowerPointスライド資料の作成

  • MarkdownからPowerPoint形式への変換。

    pandoc book.md -o book.pptx

カスタマイズ

  • テンプレートやカスタムCSSを使って、見た目やレイアウトを自由に変更。

Pandocの微妙な点

変換ツールに過ぎないこと

  • 変換前の形式をある程度整える必要がある
  • テンプレートに使用するファイルもPandoc用に整備が必要
  • ライターオプション例
  • 雑に使うだけならMarpとかの方が使いやすいかも

Pandocを使った自己開発物の紹介

プロジェクト概要

  • リポジトリ: lt-slide-warehouse
  • 内容:
    • Pandocを活用して作成したスライド資料を管理・公開するプロジェクト。
    • 簡単にスライド資料を生成・配布可能。

主な使用技術

まとめ

Pandocの魅力

  • 多様な形式への変換が可能。
  • 簡単なコマンド操作で多数の形式のドキュメントを作成可能
  • テンプレートを利用したスライド資料への対応も可能

参考リンク