1. はじめに
1.1 このマニュアルの目的
このマニュアルでは、Pandocというツールを使用してMarkdown形式のテキストからPowerPoint形式のプレゼンテーションを作成する手順を学びます。Markdownはシンプルにドキュメントを書くのに非常に適しており、Pandocを使えば簡単に他の形式（例えばPowerPoint）に変換できます。
特に、以下のことができるようになることを目標としています：
- Markdownを使って簡単にプレゼンテーションを作成する
- Pandocを使ってMarkdownをPowerPointに変換する
1.2 PandocとMarkdownとは？
Pandocは、さまざまな文書形式を相互に変換できる非常に強力なオープンソースツールです。Pandocを使うことで、MarkdownからWord、HTML、PowerPointなどに簡単に変換が可能です。
Markdownは、シンプルな記述ルールを使ってドキュメントを作成できるマークアップ言語です。例えば、#を使うだけで見出しを簡単に書くことができるため、学習コストが低く、文章を書くのがとても楽になります。
2. Pandocのインストールと準備
2.1 Pandocのインストール方法
Pandocを使うには、まずPandocをインストールする必要があります。以下に主要なOSごとのインストール方法を説明します。
2.1.1 Windowsの場合
- Pandocの公式サイト（https://pandoc.org/installing.html）からインストーラーをダウンロードします。
- ダウンロードしたインストーラーを実行し、画面の指示に従ってインストールを完了します。
2.1.2 Macの場合
- Macでは、Homebrewを使ってPandocをインストールできます。以下のコマンドをターミナルに入力してください：
brew install pandoc2.1.3 Linuxの場合
- UbuntuなどDebian系の場合：
sudo apt-get install pandoc- FedoraなどRed Hat系の場合：
sudo dnf install pandoc2.2 コマンドラインツールの基本的な使い方
Pandocはコマンドラインから使用しますので、まずは基本的なコマンドライン操作を理解しておきましょう。
- コマンドプロンプト（Windows）またはターミナル（Mac, Linux）を開く。
- 基本コマンド:
- ディレクトリの内容を見る：
dir（Windows）、ls（Mac, Linux） - ディレクトリの移動：
cd <フォルダ名>
これらの操作を使って、Pandocを実行するために適切な場所に移動できます。
3. Markdownの基本
3.1 Markdownって何？なぜ使うの？
Markdownは、ドキュメント作成を簡素化するために作られた軽量のマークアップ言語です。例えば、リッチテキストエディタのように見栄えを気にせずに、構造を明確にしながら文書を書くことができます。
- 簡単な記法で書ける:
#で見出し、*で箇条書き、[]()でリンクなど、シンプルなルールで書けます。 - フォーマットの互換性: Markdownファイルはテキストファイルとして扱えるので、簡単に他の形式に変換できます（Pandocを使うことで、PowerPointにも変換可能です）。
3.2 基本的な書き方
Markdownにはいくつかの基本的な構文があります。
3.2.1 見出し
見出しを作成するには、#を使います。
# 見出し1
## 見出し2
### 見出し33.2.2 リスト
箇条書きリストを作成するには、-を使います。
- リスト項目1
- リスト項目2番号付きリストも簡単に作成できます。
1. 項目1
2. 項目23.2.3 リンク
リンクを作成するには、[]()の形式を使います。
[OpenAIのサイト](https://www.openai.com)3.2.4 画像
画像を追加する場合も、リンクと似た記法です。
4. Markdownをスライドにする方法
4.1 スライドの区切り方（---の使い方）
Pandocを使ってMarkdownからPowerPointに変換する際、スライドごとに内容を区切るには---を使います。
# タイトルスライド
これはプレゼンテーションの概要です。
---
# スライド1
ここにはスライドの内容を書きます。
- ポイント1
- ポイント24.2 プレゼンテーションを構造化する見出しの使い方
スライド内で情報を階層的に整理するには、Markdownの見出し記法（#、##など）を使います。見出しがスライドタイトルに、箇条書きなどがスライドの内容として反映されます。
5. PandocでMarkdownからPowerPointに変換する方法
5.1 Pandocの基本コマンド
Pandocを使ってMarkdownファイルをPowerPoint形式に変換するためには、次の基本コマンドを使います。
pandoc input.md -o output.pptxinput.md: 変換したいMarkdownファイルの名前です。output.pptx: 出力されるPowerPointファイルの名前です。
5.2 実際の変換例（簡単なサンプル）
例えば、presentation.mdというMarkdownファイルをPowerPointに変換したい場合、次のようにコマンドを実行します：
pandoc presentation.md -o presentation.pptx6. 変換したPowerPointをカスタマイズする
6.1 カスタムテンプレートを使う（簡単な説明）
Pandocを使用する際には、PowerPointテンプレートを利用することで、変換後のスライドデザインをカスタマイズできます。これにより、自分のスタイルや企業のブランドに合ったスライドを作成することが可能です。
6.1.1 カスタムテンプレートの指定方法
PowerPointテンプレートを使用する場合、以下のように--reference-docオプションを使います：
pandoc input.md -o output.pptx --reference-doc=template.pptxtemplate.pptx: 自分で作成したカスタムテンプレートファイルです。このファイルには、フォント、配色、背景デザインなどが含まれています。
このコマンドを使うと、input.mdの内容をtemplate.pptxのデザインに基づいて変換したPowerPointファイルを出力します。
6.2 テンプレートを使わずにフォントや色を調整する
テンプレートを使わずにフォントや色を変更したい場合、PowerPointで直接編集するのが最も簡単です。Pandocで生成したスライドを開き、PowerPointの編集機能を使ってテキストのフォントや色を自由に変更しましょう。
特に、基本的なレイアウトが整った状態で出力されるため、簡単な編集でプロフェッショナルなプレゼン資料に仕上げることができます。
7. トラブルシューティング
7.1 よくあるエラーとその対策
Pandocを使用してMarkdownからPowerPointに変換する際に遭遇しやすいエラーとその対策について説明します。
7.1.1 エラー：ファイルが見つからない
- エラーメッセージ: “Could not find input.md”
- 原因: 指定したファイルが存在しない、もしくはパスが間違っている。
- 対策: コマンドを実行する前に、
input.mdファイルが正しい場所に存在するか確認します。また、ファイル名が正しく入力されているかも確認してください。
7.1.2 エラー：テンプレートが見つからない
- エラーメッセージ: “Could not find template.pptx”
- 原因: 指定したテンプレートファイルが存在しない。
- 対策: テンプレートのパスとファイル名が正しいか再確認し、ファイルがアクセス可能な場所にあるか確認します。
7.2 変換がうまくいかないとき
スライドが思ったように変換されない場合、以下の点をチェックしましょう：
- Markdownファイルの記述が正しいか、特に見出しやスライドの区切り（
---）が適切に設定されているか。 - Pandocのコマンドが正しく記述されているか。
また、シンプルなMarkdownファイルでまず試して、問題を切り分けるのも良い方法です。
8. 実際のプロジェクト例
8.1 Markdownの簡単なサンプルからPowerPointに変換する手順
以下にMarkdownファイルの簡単な例を示し、それをPowerPointに変換する方法を説明します。
8.1.1 サンプルMarkdown
---
title: "初めてのPandocプレゼン"
author: "山田太郎"
date: "2024年10月5日"
---
# はじめに
Pandocを使ってMarkdownからPowerPointに変換する方法を学びます。
---
# 使用方法
- Pandocのインストール
- Markdownの基本
- 変換手順8.1.2 変換手順
このMarkdownファイルをPowerPointに変換するには、次のコマンドを実行します：
pandoc sample.md -o sample.pptx8.2 Markdownを書くときのヒント
- シンプルに書く: Markdownの強みはシンプルさです。スライドの内容を簡潔にまとめ、箇条書きを活用することでプレゼンテーションが見やすくなります。
- セクションごとに分ける: 各セクションをスライドに分けることで、視聴者にとってわかりやすい構造になります。
9. 次のステップ
9.1 もっと便利に使うための追加のツールとリソース紹介
PandocとMarkdownを使いこなすことで、より効率的にドキュメントを作成できますが、さらに便利なツールを使うことで作業をスムーズにすることができます。
9.1.1 Markdownエディタ
- Visual Studio Code (VS Code): Markdown用の拡張機能を使うことで、プレビューを確認しながらMarkdownファイルを作成できます。
- Typora: WYSIWYGエディタで、書きながらプレビューを確認できるため、初心者にも使いやすいです。
9.1.2 Pandocの公式ドキュメント
Pandocの詳細な使い方については、公式ドキュメント（https://pandoc.org/）が参考になります。様々なオプションや機能を学ぶことで、より高度な使い方も可能になります。
9.2 Pandoc公式ドキュメントやコミュニティへの案内
- 公式サイト: Pandocの公式ドキュメントには、コマンドオプションやフォーマットの例が豊富に掲載されています。
- コミュニティフォーラム: 質問がある場合、Stack Overflowなどのフォーラムで質問するのも良いでしょう。他のユーザーからのアドバイスやサポートを得ることができます。
