Type for optional array element not hyperlinked

[techfg]

What package is the bug related to?

typedoc-plugin-markdown

Describe the issue

For a function that accepts an array of optional elements, the type of the element is not hyperlinked in the generated markdown doc.

For example, given:

export type Stuff = { a: string; b: string };
export const handleArrayOfOptionalStuff = (a: [Stuff?]) => {};

The generated markdown will be:

• **a**: [`Stuff?`]

Repro: https://stackblitz.com/edit/vitejs-vite-nypddu

Steps to Reproduce

1. Open repro
2. npm run docs:md
3. View files in docs-md/functions

Actual Result
Generated markdown "links" the type Stuff for handleStuff, handleOptionalStuff, handleArrayOfStuff but not for handleArrayOfOptionalStuff

Additional Information

1. The issue does not occur when generating html files (npm run docs:html)
2. The issue does not occur for optional parameters, only arrays with optional elements

TypeDoc configuration

typedoc: 0.26.11
typedoc-plugin-markdown: 4.2.10
typescript" 5.6.3

Expected behavior

The generated markdown should contain a hyperlink to Stuff:

• **a**: [[`Stuff`](../type-aliases/Stuff.md)]

[tgreyuk]

Thanks for detailed description.

Fix in typedoc-plugin-markdown@4.3.0

https://github.com/typedoc2md/typedoc-plugin-markdown-scratchpad/blob/main/issues/719/docs/md/functions/handleArrayOfStuff.md

Please note parameters layout has been tweaked in listing view to make a bit clearer. For a concise view parametersFormat-table can be used.

[techfg]

Hi @tgreyuk -

Thanks for the quick response on this, greatly appreciated!

In the repro provided, all looks good! Unfortunately, when the type includes union and the entire union itself is optional, the docs do not emit correctly.

Repro: https://stackblitz.com/edit/vitejs-vite-vyxrtv?file=src%2Findex.ts

TypeDoc configuration
typedoc: 0.27.0
typedoc-plugin-markdown: 4.3.0
typescript" 5.7.2

export const handleArrayOfOptionalStuff = (
  a: [(null | undefined | Stuff)?]
) => {};

Actual Result

### a

[`null` \| [`Stuff`](../type-aliases/Stuff.md)?]

Expected Result

### a

[(`null` \| [`Stuff`](../type-aliases/Stuff.md))?]

Actual HTML Result

[tgreyuk]

Fix in typedoc-plugin-markdown@4.3.1

[techfg]

Looks great in 4.3.1, thank you @tgreyuk!