GitHub Pages は、Markdown ファイルをウェブサイトに変換し、インターネット上で無料でホスティングするサービスです。GitHub の使用方法を知っていて、シンプルなウェブページを作成する必要がある場合、GitHub Pages より優れたものはありません。GitHub で新しいリポジトリを作成し、Markdown ファイルをコミットして、GitHub Pages 機能を有効にするだけです。
GitHub Pages は、Jekyll 静的サイトジェネレーターを使用してウェブサイトを作成し、Markdown のサポートは優れています。GitHub のプリメイドテーマのいずれかを選択するか、Jekyll テーマ を使用するか、独自の CSS を使用することができます。以下は、GitHub のプリメイドテーマの1つを使用したサンプルウェブページです。
混乱を招くことに、GitHub Pages は GitHub とは異なる方法で Markdown をレンダリングします。GitHub は独自の Markdown プロセッサを使用しますが、GitHub Pages は jekyll-commonmark を使用します。つまり、README.md ファイルは、GitHub のウェブサイトと GitHub Pages ウェブサイトで異なる表示になります。たとえば、絵文字は GitHub のウェブサイトではレンダリングされますが、GitHub Pages を使用して生成されたウェブサイトではレンダリングされません。
GitHub Pages の Markdown サポート
GitHub Pages は、以下の Markdown 要素をサポートしています。
| 要素 | サポート | 備考 |
|---|---|---|
| 見出し | はい | |
| 段落 | はい | |
| 改行 | はい | |
| 太字 | はい | |
| 斜体 | はい | |
| 引用ブロック | はい | |
| 番号付きリスト | はい | |
| 箇条書きリスト | はい | |
| コード | はい | |
| 水平線 | はい | |
| リンク | はい | |
| 画像 | はい | |
| 表 | はい | |
| 囲まれたコードブロック | はい | |
| 構文ハイライト | はい | syntax_highlighter: rouge が _config.yml ファイルの kramdown セクションにあることを確認してください。 |
| 脚注 | はい | |
| 見出し ID | はい | |
| 定義リスト | はい | |
| 取り消し線 | はい | 2つのチルダ (~~word~~) または1つのチルダ (~word~) を使用できます — 両方とも機能します。 |
| タスクリスト | はい | |
| 絵文字 (コピー＆ペースト) | 不明 | |
| 絵文字 (ショートコード) | 不明 | |
| ハイライト | いいえ | |
| 下付き文字 | いいえ | |
| 上付き文字 | いいえ | |
| 自動 URL リンク | はい | |
| 自動 URL リンクの無効化 | はい | |
| HTML | はい |
追加の構文要素のサポート
追加のボーナスとして、GitHub Pages はいくつかのマイナーな要素をサポートしています。
| 要素 | Markdown | レンダリングされた出力 |
|---|---|---|
| 略語 | *[HTML]: ハイパーテキストマークアップ言語HTML 仕様は W3C によって維持されています。 |
HTML 仕様は W3C によって維持されています。 |
こちらも参照してください
Markdown スキルを次のレベルに引き上げましょう。
60ページで Markdown を学びましょう。初心者と専門家の両方に設計された、Markdown ガイドの本は、Markdown 構文の学習と習得に必要なすべてを網羅した包括的なリファレンスです。
書籍を入手するMarkdown をもっと学びたいですか？
ここで終わりではありません！ 🚀 GitHub リポジトリ をスターに追加し、以下のメールアドレスを入力して、メールで新しい Markdown チュートリアルを受け取ってください。スパムはありません！