docs: add useBrokenLink hook section

website/docs/docusaurus-core.mdx

@@ -605,6 +605,38 @@ const MyComponent = () => {
 };
 ```
 
+### `useBrokenLinks` {#useBrokenLinks}
+
+React hook to access the BrokenLinks context. The context provides methods for collecting and managing information about anchors and links.
+
+Usage example:
+
+```js
+import useBrokenLinks from '@docusaurus/useBrokenLinks';
+
+// MyHeading component
+export default function MyHeading({id, ...props}): JSX.Element {
+  const brokenLinks = useBrokenLinks();
+
+  brokenLinks.collectAnchor(id);
+
+  return <h1 id={id}>Heading</h1>;
+}
+```
+
+```js
+import useBrokenLinks from '@docusaurus/useBrokenLinks';
+
+// MyLink component
+export default function MyLink({targetLink, ...props}): JSX.Element {
+  const brokenLinks = useBrokenLinks();
+
+  brokenLinks.collectLink(targetLink);
+
+  return <a href={targetLink}>Link</a>;
+}
+```
+
 ## Functions {#functions}
 
 ### `interpolate` {#interpolate-1}