いくつかのリポジトリとユーザー ページに github ページを追加中です。多くの Web ページで、Markdown 形式を使用したいと考えています。
ただ、どうすればよいのか、漠然とした詳細な情報しか見つからないので、試行錯誤しながら仕組みを探っています。
実際のドキュメントはどこにありますか? 悲惨な詳細?
これまでに見つけた最良の情報は次のとおりです。
- 特別なブランチ名
gh-pages
を使用して、プロジェクト リポジトリのサイトを作成します ファイルの先頭に 3 行の呪文が必要です。
--- title: something ---
- 接尾辞はに変更されます
.html
しかし、次のような詳細について多くの質問が残っています。
- css ファイルをインポートできますか?
- その「タイトル」の宣伝文句は実際に何をしますか?
- ファイルに必要なサフィックスは何ですか?
などですので、すべての機能の詳細なドキュメントをぜひご覧ください。
この質問は Markdown 構文の使用方法に関するものではなく、ユーザーおよびプロジェクト ページの範囲内で Markdown から HTML を自動的に作成するための github の魔法を利用する方法に関するものであることに注意してください。