【Marp】ドコでもMarkdownを使って資料を作れる環境を用意してみる。【GitPod】

Markdownでスライドを作成する為のツールであるMarpとブラウザからお手軽に仮想開発環境を用意するコトを可能にするGitpodを使いドコでも資料を作成することを可能にする方法を紹介します。

Transcript

1. 【Marp】ドコでもMarkdownを使って資料を作れる環 境を用意してみる。 【GitPod】 T4D4
2. Agenda 自己紹介 前提知識 実際の作業手順
3. 自己紹介 名前: T4D4 X a.k.a Twitter: @T4D4
4. 前提知識 Marpとは？ Marpとは、Markdown記法でスライドを作成するためのツールです。 詳細は公式サイトを参照してください。 Gitpodとは？ Gitpodとは、GitHub、Gitlab、BitbucketのためのワンクリックオンラインIDE です。 詳細は公式サイトを参照してください。
5. 実際の作業手順 1. 事前準備としてGitHub上で空のリポジトリとGitpodのアカウントを用意します。 Gitpodのアカウントを作成する時、GitHubのアカウントを選択してくださ い。
6. 2. GitpodのworkspaceからNew Workspaceボタンをクリックして新しいワークスペ ースの作成を行います。 新しいワークスペースを作成するページでは、連携させるレポジトリ、使用 するエディター、VMの性能を選択します。 2.1. まず、1番上の項目で連携させるレポジトリを選択します。ここで1番最初の事前 準備の段階で作成したリポジトリを選択します。
7. 2.2. その後、エディターとVMの性能を選択してCreate a Workspaceボタンをクリック します。 VMの性能はお財布などと相談して好きに選択してください。 エディターはドコでも資料を作れる環境という本スライドの趣旨を重視する場合 はVScode・Browserを選択してください。しかし、ブラウザ版では一部の拡張機 能（GitHubCopilot等）が使えない場合があるみたいなので、パソコン上でしか使 わないならお好きなエディターを選択すると良いと思います 3項目の設定の完了後、continueボタンのクリックでワークスペースが作成されま す。
8. 3. 少し待つとブラウザでVScodeライクなUIのエディターがブラウザ上で開かれると 思います。 （デスクトップアプリ版で開きたい場合は左下に下のようなポップアッ プが出てきたらOpenをクリック） エディターが開かれたら、ドコでも開発をできるようにする環境自体は整いま す。あとは、スライドを作成するために必要な環境を整えます。
9. 4. 拡張機能を導入します。 左のサイドバーの下から2番目のアイコンをクリックして拡張機能の検索を行 います。 検索バーに「Marp」と入力して、 「Marp for VS Code」という名前の拡張機 能をインストールします。
10. 5. GitpodのVMにChromeをインストールします。 Marpでは、Markdownで書いたスライドをpptxやpdf形式で出力する際にブラウザ を必要とします。どうやらGitpodの方にブラウザが入っていないとダメなような ので、CLIからChromeをインストールします。 インストールコマンド例↓ wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | sudo apt-key add - sudo sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list' sudo apt update sudo apt install google-chrome-stable
11. 6. 日本語フォントのインストール ローカルな環境でMarpを使う場合は、日本語フォントが入っていると思います が、gitpodのVMには入っていません。このままでは出力したファイルの日本語が □になってしまい読めないので、日本語フォントをインストールします。 インストールの方法とフリーダウンロード可能な日本語フォントについてこちら の記事が詳しいので参考にしてみてください。 フォントのインストールが完了すればコレでスライドを作成するために必要な環 境のセットアップは完了です。
12. おまけ 最低限必要な拡張機能として「Marp for VS code」だけをインストールしました。しかし、 VScodeには他にも便利な拡張機能はたくさんあるので、僕が実際にMarpでスライドを作成する 際に使っている拡張機能の一部を紹介します。 GitHub Copilot GitHubの提供するAIです。文章書いてる時にもアシストが働いてくれて便利 です。 Code Spell Checker コード内のスペルミスを検出してくれる拡張機能です。 vscode-textlint、テキスト校正くん テキスト校正くんは、日本語の文章をチェックしてくれる拡張機能です。 vscode-textlintは、文章をルールにしたがってチェックするtextlintというツー ルをvscode上で使う為の拡張機能です。
13. 参考リンク Marp公式サイト Gitpod公式サイト Linux で標準的に使われるフリー日本語フォント GitHub Copilot - Visual Studio Marketplace Code Spell Checker - Visual Studio Marketplace vscode-textlint - Visual Studio Marketplace テキスト校正くん - Visual Studio Marketplace