Markdown export

[guillaumemeyer]

Being able to export to Markdown instead of Word would be great.
Could be done either by using a specific Markdown template, or converting Word to Markdown using something like Pandoc.

[modery]

Working on it! Early stage at the moment, and generating the markdown directly (instead of using Word to Markdown)

When you say "a specific Markdown template", what do you actually mean? Want to see what other options there are, which I haven't thought of yet

[guillaumemeyer]

Sorry for being confusing. When I said "a specific Markdown template", I meant a direct Markdown generation without Word conversion.

[guillaumemeyer]

As an additional suggestion, for charts, you may consider using Mermaid instead of generating images.
Mermaid is now natively supported by GitHub and pretty much by all Markdown tools out there.
Benefits: charts would be plain text and therefore searchable, easily editable...

[modery]

Thanks for clearing up the confusion, I'm on the rigfht track then! Mermaid is something that will come in a "second phase", working on the general Markdown documentation first. Need to see if I can release them both together, or if the first release is simply markdown files that use the SVG/PNG images, or if I can include the Mermaid generated images as well

[modery]

Short update: didn't have too much time due to other commitments, and some parts were a bit tricky. But made some progress with generating the Markdown for the Flow documentation, hoping to get this completed within the next 10 days. Current status:

[modery]

Hi @guillaumemeyer , a first version of the generated Markdown documentation for a Flow can be reviewed here: https://github.com/modery/PowerDocuMDFeedback
Can you check and provide any feedback (structure, other recommendations, ...)?

App documentation to be added later this month (development in progress)

[guillaumemeyer]

First bird's eye view look great!
I just Noticed the flow name is repeated twice in pages header...
Aside from this it should do the job for a v1, congrats @modery

[modery]

1.0 is out, possible to generate the documentation in Markdown format now. But thinking of ways to improve it, might move the individual controls in the various screens into their own page (current pages are too long), similar to what I've done for Power Automate actions

https://github.com/modery/PowerDocu/releases/tag/v-1.0.0