Generate other file type than html

[MatthieuLebigre]

Hi,
First thanks to your great works on this project !
I would like to use it to generate a doc in Markdown. I can do it thanks to the templates, but the file extension is still html, I have no way to change. I do it by renaming the files with a script, but it would be nice to be able to configure the output file extension.

[aciccarello]

@MatthieuLebigre This seems similar to #174 but it sounds like you got further than he did.

To reiterate, it sounds like this RFC is to allow templates to be outputted with different file types.

[MatthieuLebigre]

Exactly, my goal is to have a complete Markdown documentation generated.

Maybe in the temaplates if we should be able to configure the output somehow, it would be awesome. And the best would be able to mix different output in the same theme : for exemple html and markdown files. (not my need, but could be usefull in the future)

[jonaskello]

@MatthieuLebigre I'm also looking to create markdown output. Could you provide some info how you made it work?

[MatthieuLebigre]

Hi @jonaskello
I'm using this theme: [https://www.npmjs.com/package/typedoc-markdown-theme]
Unfortunatly it's not working so well (file extension is still html, link between pages is broken, ...). With a few manual steps, I can generate a doc.
We plan on do something about that (contribute to Typedoc, or a better theme maybe), but for now it's on hold

[jonaskello]

@MatthieuLebigre Thanks for the info, I'll give it a try!

[Ledragon]

Hi everyone,
Not sure if this is still an active discussion, but if so, I might be interested as well. Being what I am, though, I started doing something on my side before searching the issues...

This is C# (.NET Core), and I am basically parsing the json output by TypeDoc to create markdown files. The result can be seen here. The whole wiki was generated from the json output file, except the Home page and sidebar.

[Gerrit0]

There is a markdown theme that demonstrates one way to generate .md files instead of .html, typedoc-plugin-markdown. This plugin is advertised in the readme for future searchers to find.