diff --git a/packages/mermaid/src/mermaid.ts b/packages/mermaid/src/mermaid.ts
index 1801f5122..ce858f3b7 100644
--- a/packages/mermaid/src/mermaid.ts
+++ b/packages/mermaid/src/mermaid.ts
@@ -409,7 +409,7 @@ export interface Mermaid {
   startOnLoad: boolean;
   parseError?: ParseErrorFunction;
   /**
-   * @deprecated Use {@link parse} and {@link render} instead. Please open a discussion https://github.com/mermaid-js/mermaid/discussions if your use case does not fit the new API.
+   * @deprecated Use {@link parse} and {@link render} instead. Please [open a discussion](https://github.com/mermaid-js/mermaid/discussions) if your use case does not fit the new API.
    * @internal
    */
   mermaidAPI: typeof mermaidAPI;