Integration with TypeDoc

[TooTallNate]

I'm curious if and how are people integrating TypeDoc output into Fumadocs?

I am currently looking into using typedoc-plugin-markdown for this, but wondering if there's any better solutions.

[fuma-nama]

Fumadocs comes with a Typescript integration which generates docs from type definitions, you can refer to the docs. If you want more features, welcome to open a feature request

[TooTallNate]

Oh right, I forgot about that. I was evaluating using it, but I'm having trouble wrapping my head around it. I have a monorepo with a few packages, and I want to have separate pages for every exported item. Do I need a .model.mdx file for every single type/class/interface/etc.? How would I go about doing that in an automated way?

[fuma-nama]

Unfortunately yes, I'm not aiming to make a generator that generates the entire docs based on typedoc, and the currently API is mainly built for the official docs site itself. It's useful for smaller use cases like generating docs for UI components (with auto type table), but you might want to use the plugin you have mentioned (or other parts of the ecosystem) if they suit you better.

You can suggest some features too, but has to be more specific (like what API exactly do you need)

[fuma-nama]

Also I've documented the generateMDX API, you can pass the MDX content instead of specifying them via files.

[TooTallNate]

I ended up getting to a TypeDoc + typedoc-plugin-markdown configuration that I am satisfied with (example).

One thing that would be nice would be the ability to disable the TOC links up to a certain level, i.e. I don't want TOC links for <h3> or greater to remove all these "Returns" links:

[fuma-nama]

In fact you can easily do this from your page.tsx, filter the toc items before passing it to the page component

[TooTallNate]

Ahh right, ya makes sense. Thanks, I'll get that handled.