Docusaurusで作成されたウェブサイトからのコードフォーマットブロックを含むテキストを貼り付けると、エディタがフォーマットを崩してしまいます。本来、コードブロック全体が ``` で囲まれるべきところ、最初の行の後に閉じの ``` が挿入され、コードブロック内の他の各行の前後に ` が付与されてしまいます。また、コードブロック内の行間に空行も挿入されます。
このセクションを貼り付けた場合の例を以下に示します:Create a doc | Docusaurus コードブロックが連続したブロックではなく、個別の行になっていることに注目してください。これはDocusaurusで構築されたサイト全般で発生する問題であり、Docusaurusの公式サイトに限ったことではありません。
すべてのドキュメントには一意の id があります。デフォルトでは、ドキュメントの id は、ルートドキュメントディレクトリからの相対パス(拡張子を除いたファイル名)になります。
例えば、greeting.md のIDは greeting、guide/hello.md のIDは guide/hello になります。
website # サイトのルートディレクトリ
└── docs
├── greeting.md
└── guide
└── hello.md
ただし、id の最後の部分は、フロントマターでユーザーが定義できます。例えば、guide/hello.md の内容が以下のように定義されている場合、最終的な id は guide/part1 になります。
---
id: part1
---
Lorem ipsum
IDは、サイドバーを手動で記述する場合や、ドキュメント関連のレイアウトコンポーネントやフックを使用する場合に、ドキュメントを参照するために使用されます。