Markdown言語入門

講義で生成AI時代の必須教養であるマークダウン言語について解説しました、
ビデオはこちら：https://youtu.be/Jovp9JbkjCc
#エージェント #AI #生成AI #講義 #LLM
@サプライ・チェイン最適化チャンネル（MIKIO KUBO)
https://www.moai-lab.jp/
https://youtube.com/@kubomikio
https://x.com/MickeyKubo

Transcript

1. Markdown 入門 〜初心者のための基本 ガイド〜 Markdown は簡潔で読みやすいテキスト形式で文書を作成できる軽量 マークアップ言語です。このスライドでは、Markdown の基本から応 用までを初心者向けに解説します。 1
2. Markdown とは何か Markdown は、プレーンテキストをHTML やその他のフォーマットに 簡単に変換できるマークアップ言語です。2004 年にJohn Gruber と Aaron Swartz によって開発されました。 2
3. 主な特徴 プレーンテキストで書けるため、どのテキストエディタでも編集可 能 シンプルな構文で学習が容易 書式装飾よりも内容に集中できる 広く普及しており、様々なプラットフォームでサポートされている 3
4. Markdown を使う利点 1. 簡潔さと読みやすさ: シンプルな構文で読みやすい文書作成が可能 2. プラットフォームの独立性: どのデバイスやエディターでも使用可能 3. 学習が早い: 直感的な構文で短期間で習得できる 4. 幅広い採用: GitHub 、WordPress 、様々なブログシステムなどで使 用されている 5. 速度と効率: 書式よりも内容に集中できるため、文書作成が効率的 4
5. Markdown の基本構文 5
6. 見出し 見出しは # 記号で表現します。 # の数が見出しのレベルを示します。 # 見出し1 ## 見出し2 ### 見出し3 #### 見出し4 ##### 見出し5 ###### 見出し6 6
7. 段落と改行 段落は空行で区切ります。改行するには、行末に2 つ以上の半角スペー スを入れます。 1段落目 2段落目 1行目（行末に2つ以上の半角スペース） 2行目 7
8. 強調（太字・斜体） テキストを強調するには、アスタリスク( * ) やアンダースコア( _ ) を使 います。 *斜体* または _斜体_ **太字** または __太字__ ***斜体と太字*** または ___斜体と太字___ 8
9. リスト 番号なしリスト 行頭に * 、 - 、 + のいずれかを使います。 * リスト項目1 * リスト項目2 * サブ項目1 * サブ項目2 9
10. 番号付きリスト 行頭に数字とドット( . ) を使います。 1. リスト項目1 2. リスト項目2 1. サブ項目1 2. サブ項目2 10
11. 応用的な構文 11
12. リンク リンクは [リンクテキスト](URL) の形式で書きます。 [Google](https://www.google.com) [Google](https://www.google.com "Googleへのリンク") 12
13. 画像 画像は`` の形式で書きます。   13
14. コードブロック インラインコード バッククォート( ` ) で囲みます。 これは `インラインコード` です。 14
15. コードブロック バッククォート3 つで囲み、言語を指定するとシンタックスハイライ トが有効になります。 def hello(): print("Hello, world!") 15
16. 表 縦線( | ) とハイフン( - ) を使って表を作成します。 | 見出し1 | 見出し2 | | ------- | ------- | | セル1 | セル2 | | セル3 | セル4 | 16
17. 引用 行頭に > を使います。 > これは引用です。 >> ネストされた引用です。 17
18. 水平線 3 つ以上のハイフン( - ) 、アスタリスク( * ) 、アンダースコア( _ ) で表現 します。 --- *** ___ 18
19. Markdown でスライドを作成できるツール 19
20. Marp VSCode の拡張機能として利用可能 HTML やPDF 、PowerPoint としてエクスポート可能 CSS でカスタマイズ可能 スライドを --- で区切る 20
21. Remark.js シンプルなデザインが特徴 HTML ファイルに直接Markdown を書く方式 CSS でスタイル調整可能 21
22. Slidev Markdown とVue.js でスライド作成可能 コードブロックのシンタックスハイライトが優れている インタラクティブな要素を追加可能 多様な公開方法に対応（PDF 、PPTX 、PNG 、Web ページのSPA ） 22
23. 実践的な使い方 Markdown は様々な場面で活用できます： GitHub のREADME.md ファイル ブログ記事の執筆 技術文書の作成 チームでの情報共有ドキュメント プレゼンテーションスライド 23
24. Markdown で数式を記述する方法 24
25. 1. Markdown で数式を書く理由 数式をそのままテキストで表現でき、論文や技術資料の作成に便利 GitHub やMarp 、VSCode など多くのツール・サービスでサポート 25
26. 2. 数式記述の基本ルール インライン数式 テキスト中に数式を埋め込む場合は、数式を $ で囲む これはインライン数式 $y = x^2 + 1$ の例です。 26
27. ブロック数式 独立した数式を表示する場合は、数式を $$ で囲む $$ y = x^2 + 1 $$ 27
28. 3. よく使うLaTeX 数式記法 記法 表現例 結果例 2 乗 $$x^2$$ ルート $$\sqrt{x}$$ 分数 $$\frac{a}{b}$$ 総和 $$\sum_{i=1}^n a_i$$ 積分 $$\int_a^b f(x)dx$$ 行列 $$\begin{pmatrix}1 & 2\3 & 4\end{pmatrix}$$ 28
29. 4. Markdown スライド（Marp 等）での数式サポート Marp やGROWI などのMarkdown スライドツールでは、上記の記法 で数式をそのままスライドに表示できる $...$ や $$...$$ で囲むだけでOK KaTeX またはMathJax によるレンダリングが一般的 29
30. 5. 注意点・補足 一部のMarkdown エディタやサービスでは、数式表示のために MathJax やKaTeX の設定が必要な場合がある GitHub やVSCode 、Marp など主要なツールでは標準でサポートされ ていることが多い サポートされていない場合、MathJax のスクリプトを埋め込んで対 応可能 30
31. まとめ Markdown は簡単に習得でき、効率的に文書作成ができる軽量マー クアップ言語です 基本構文（見出し、段落、リスト、強調）は数分で習得できます 応用的な構文（コード、表、引用）で文書の表現力が高まります Marp やRemark.js 、Slidev などのツールを使えば、Markdown だけ でプレゼンテーションスライドも作成できます Markdown は一度覚えれば長く使える実用的なスキルです。ぜひ日常 的な文書作成に取り入れてみてください。 31