このガイドでは、Discourse の投稿またはトピック内の見出しに直接リンクする方法を説明し、ユーザーが長い投稿を効率的に移動できるようにします。
必要なユーザーレベル: 全てのユーザー
長い投稿内に見出しを追加すると、コンテンツの可読性が向上し、ユーザーが特定のセクションに直接リンクできるようになります。これは、広範なディスカッションやドキュメントをナビゲートする際に特に役立ちます。
概要
このガイドでは、以下について説明します。
- Markdown を使用した見出しの作成
- 投稿内の特定の見出しへの直接リンク
Markdown を使用した見出しの作成
Markdown で見出しを作成するには、テキストの行の先頭に 1 つ以上の # 文字を付けます。# の数は見出しのレベルに対応します。以下に例を示します。
## レベル 2 の見出し
その後には短い段落が続きます。
### レベル 3 の見出し
別の短い段落が続きます。
レンダリングすると、次のようになります。
レベル 2 の見出し
その後には短い段落が続きます。
レベル 3 の見出し
別の短い段落が続きます。
見出しへの直接リンク
投稿内の見出しへの直接リンクを共有するには：
- 見出しの上にカーソルを合わせると、隣にリンクアイコンが表示されます。
- リンクアイコンをクリックすると、ブラウザのアドレスバーの URL がその見出しへの直接リンクに更新されます。
- アドレスバーから更新された URL をコピーして共有します。
リンクアイコンは、見出しの上にカーソルを合わせたときに、デスクトップ (非タッチ) デバイスでのみ表示されます。タッチデバイスやモバイルデバイスでは、アンカーリンクはページ内に存在しますが、表示されません。
見出しのアンカー URL の理解
見出しのリンクアイコンをクリックすると、アドレスバーの URL が次の形式のフラグメントに更新されます。
#p-{postId}-{slugified-heading}-{number}
たとえば、投稿 12345 内の「Getting Started」という見出しは、#p-12345-getting-started-1 のような URL フラグメントを生成します。末尾の番号は、投稿内での見出しの位置に基づいた連番カウンターです。
ベストプラクティス
- コンテンツを明確に要約するために、説明的な見出しを使用します。
- 適切な場合は、階層的な見出しを使用して投稿を構成します。
- 可読性を高めるために、見出しが一貫性があり論理的であることを確認します。
- 見出しのテキストを編集したり、見出しの順序を変更したりすると、アンカー URL が変更され、既存のリンクが壊れる可能性があることに注意してください。
よくある質問 (FAQ)
投稿の任意の部分にリンクできますか？
Markdown で適切にフォーマットされた見出しにはリンクできますが、引用ブロック内にあるものは除きます。これらのブロック内の見出しはアンカーリンクを生成しません。
見出しへのリンクは複数の投稿で機能しますか？
はい！これらのリンクは、他のトピックで使用されたり、どこかで共有されたりすると、投稿内のヘッダーに誘導します。