document: the links in the pseudocode in `doc/api/modules.md` is broken.

[chirsz-ever]

Affected URL(s)

No response

Description of the problem

The problem started appearing in Node 20, seemingly after the documentation webpages switched to rendering code blocks using highlight.js. In Node 19, the <a> tags render.

Possible solutions:

1. Avoid using links in the text block.
2. Use some technique to render these links.
3. Rewrite the entire pseudocode into a format similar to the "Resolution Algorithm Specification" section in doc/api/esm.md (link).

[AugustinMauroy]

You mean a tag isn't render in code snippets. In my opinion, it should never have worked because that’s not how Markdown code snippets work. I think the pseudocode should include comments with the links written out in plain text. Just as you would in actual code

Real world example

/**
 * @link https://www.typescriptlang.org/docs/handbook/jsdoc-supported-types.html
 */
const foo = () => {
  console.log('Hello, World!');
};

[chirsz-ever]

it should never have worked

In Node 19, the <a> tags is rendered. I agree that this is not reasonable Markdown semantics, but it obviously works in line with the intentions of the writer at the time.