ページに注記を入れるときは、必ずこの専用の書式を使います。書式付きの注記は note、caution、tip の 3 種類です。
注記についての補足です。
- 色は種類で決まります。
noteは青、cautionは黄、tipは紫です。 - どの種類でも、見出しテキストは任意です。
- どの種類にも、本文のほか、リスト、コードブロック、画像などの書式を入れられます。
注記がコンテンツ戦略のどこに位置するかは、Notes/tips/warnings を参照してください。
本文の本筋には必須でない、短い補足や追加の文脈を書くときに Note を使います。
見出しを省略すると、この aside の既定見出しは Note です。
:::note[見出し]
こんにちは、世界。
:::利用者に問題を起こしうる操作を強調するときに Caution を使います。
見出しを省略すると、この aside の既定見出しは Warning です。
:::caution[機能の競合]
機能 A と機能 B を同時に使うと、設定が正しく動作しません。
:::本文に収まりきらないベストプラクティスや、意見寄りの使い方を共有するときに Tip を使います。
見出しを省略すると、この aside の既定見出しは Tip です。
:::tip[ベストプラクティス]
Cloudflare では、DNS リゾルバーとして [1.1.1.1](/1.1.1.1/) の使用を推奨します。
:::