GitBookGitBookは、ドキュメントのウェブサイトやナレッジベースのためのホスティングソリューションです。簡単に言うと、GitBookのウェブサイトにサインインし、Webベースのエディタを使用してドキュメントを作成します。あるいは、コンテンツを管理したい場合は、GitBookと統合されたGitリポジトリに保持できます。どちらの場合でも、さまざまなウェブページを作成してそれらを論理的な順序で整理できます。すべてが希望どおりになったら、カスタムドメインで公開できます。
他の多くのプロジェクトと同様に、GitBookは商用版のオファーを備えたオープンソースのツールチェーンとしてスタートしましたが、最終的にはオープンソースプロジェクトをやめて、独自のウェブサイトで独占的にホストされる新しい独自のクローズドソースのオファリングに切り替えました。オープンソースのツールチェーンはまだ利用できますが、そのオプションはサポートされなくなったため、この記事では新しいホスティングされたオプションのみを文書化しています。
GitBookのDocusaurusなどのツールに対する利点は、GitBookがサイトの構築とホスティングを担当し、WYSIWYGコントロールはMarkdown初心者が使用できるほど直感的であることです。GitBookのウェブサイトでは、ライブエディターは、Markdownの書式設定構文を入力すると非表示にします。このエディターは少し不安定ですが、奇妙なバグを除けば、このウェブサイトは一般的にMarkdownの専門家とMarkdownの経験のない両方のユーザー向けに機能します。MarkdownでフォーマットされたテキストをGitBookのインタフェースにコピーアンドペーストすることもできます。
GitBookは、以下のMarkdown要素をサポートします。
| 要素 | サポート | 注記 |
|---|---|---|
| 見出し | あり | |
| 段落 | あり | |
| 改行 | あり | |
| 太字 | あり | |
| 斜体 | あり | |
| 引用 | あり | |
| 順序付きリスト | あり | |
| 無順序付きリスト | あり | |
| コード | あり | |
| 水平ルール | なし | |
| リンク | あり | |
| 画像 | あり | |
| 表 | あり | |
| フェンス付きコードブロック | あり | |
| 構文の強調表示 | あり | |
| 脚注 | なし | |
| 見出しID | あり | |
| 定義リスト | なし | |
| 取り消し線 | あり | |
| タスクリスト | あり | |
| 絵文字(コピーアンドペースト) | 不明 | |
| 絵文字(ショートコード) | 不明 | |
| ハイライト | なし | |
| 下付き文字 | なし | |
| 上付き文字 | なし | |
| 自動URLリンク | あり | |
| 自動URLリンクの無効化 | あり | |
| HTML | なし |
60ページでMarkdownを学びましょう。「Markdownガイド」という書籍は初心者と専門家の両方を対象としており、Markdown構文をマスターするための必要なものをすべて網羅した包括的なリファレンスです。
書籍を入手するまだ止まってはいけません!GitHubリポジトリにスターを付け、メールアドレスを入力すると、新しいMarkdownチュートリアルをメールで受け取ることができます。スパムはありません!