Out with ReHype and in with ReMark!

ReHyper operates on the HTML, while ReMark processes the Markdown, giving us an opportunity to clean up links before they are processed and link checked.

Author: khalidabuhakmeh

astro.config.mjs

@@ -183,6 +183,7 @@ export default defineConfig({
     }),
   ],
   markdown: {
+    remarkPlugins: [removeMarkdownExtensions],
     rehypePlugins: [
       [
         rehypeAstroRelativeMarkdownLinks,
@@ -202,7 +203,6 @@ export default defineConfig({
           rel: ["noopener", "noreferrer"],
         },
       ],
-      [removeMarkdownExtensions, {}],
     ],
   },
 });

src/content/docs/identitymodel-oidcclient/manual.md

@@ -10,7 +10,7 @@ redirect_from:
 
 OpenID Connect is a protocol that allows you to authenticate users
 using a browser and involves browser-based interactions. When using this
-library you can choose between two modes: [automatic](./automatic.md) and manual.
+library you can choose between two modes: [automatic](/identitymodel-oidcclient/automatic.md) and manual.
 
 We recommend using automatic mode when possible, but sometimes you need
 to use manual mode when you want to handle browser interactions yourself.

src/content/docs/identityserver/ui/login/mfa.md

@@ -9,7 +9,7 @@ redirect_from:
   - /identityserver/v7/ui/login/mfa/
 ---
 
-Duende IdentityServer itself doesn't implement multi-factor authentication (MFA). MFA is part of the login process in the user interface which is the [responsibility of the hosting application](../index.md). Microsoft provides some [general guidelines](https://learn.microsoft.com/en-us/aspnet/core/security/authentication/mfa) on how to enable MFA in ASP.NET Core.
+Duende IdentityServer itself doesn't implement multi-factor authentication (MFA). MFA is part of the login process in the user interface which is the [responsibility of the hosting application](/identityserver/ui/index.md). Microsoft provides some [general guidelines](https://learn.microsoft.com/en-us/aspnet/core/security/authentication/mfa) on how to enable MFA in ASP.NET Core.
 
 ## MFA Hosted In IdentityServer
 

src/plugins/remove-markdown-extensions.ts

@@ -1,35 +1,28 @@
 import { visit } from "unist-util-visit";
 import type { Node, Parent } from "unist";
+import type { Plugin } from "unified";
 
 interface Element extends Parent {
-  type: "element";
-  tagName: string;
-  properties: {
-    [key: string]: unknown;
-  };
-  content: Node;
+  type: "link";
+  url: string;
   children: Node[];
 }
 
-export default function removeMarkdownExtensions(): (tree: Node) => void {
+const removeMarkdownExtensions: Plugin = function () {
   return (tree: Node) => {
-    visit(tree, "element", (node: Element) => {
-      if (
-        node.tagName === "a" &&
-        node.properties &&
-        typeof node.properties.href === "string"
-      ) {
-        const match = /(?:\/index)?\.(md|mdx)(#.*)?$/;
-        if (match.test(node.properties.href)) {
-          let date = new Date().toLocaleTimeString("en-US", { hour12: false });
+    visit(tree, "link", (node: Element) => {
+      const match = /(?:\/index)?\.(md|mdx)(#.*)?$/;
+      if (match.test(node.url)) {
+        let date = new Date().toLocaleTimeString("en-US", { hour12: false });
 
-          console.log(
-            `\x1b[90m${date}\x1b[0m \x1b[95m[🔥 *.md(x)]\x1b[0m ${node.properties.href}`,
-          );
+        console.log(
+          `\x1b[90m${date}\x1b[0m \x1b[95m[🔥 *.md(x)]\x1b[0m ${node.url}`,
+        );
 
-          node.properties.href = node.properties.href.replace(match, "$2");
-        }
+        node.url = node.url.replace(match, "$2");
       }
     });
   };
-}
+};
+
+export default removeMarkdownExtensions;