Mkdocs format

[miczyg1]

Added a switch that changes the heading levels to produce a ready-to-paste report into docs.dasharo.com mkdocs

[macpijan]

Making it easier to integrate in docs.dasharo.com is great idea. Although I am wondering, if we need multiple formats? After all, it is mostly used by us, and "mkdocs" format is also a valid markdown?

[miczyg1]

Making it easier to integrate in docs.dasharo.com is great idea. Although I am wondering, if we need multiple formats? After all, it is mostly used by us, and "mkdocs" format is also a valid markdown?

Format is the same, just heading levels are different. My idea was to lower the heading levels so that only the 2nd level heading (which is the Dasharo version the report was generated for) would appear in TOC on mkdocs for better browsability

[macpijan]

Format is the same, just heading levels are different. My idea was to lower the heading levels so that only the 2nd level heading (which is the Dasharo version the report was generated for) would appear in TOC on mkdocs for better browsability

Right, so we could simply change that, without the necessity of supporting two variants of heading levels? We make it more complex, and need to edit other script using it to pass a new parameter as well. But if you believe it is worth to keep these 2 styles, I am fine with that.

[miczyg1]

Right, so we could simply change that, without the necessity of supporting two variants of heading levels? We make it more complex, and need to edit other script using it to pass a new parameter as well. But if you believe it is worth to keep these 2 styles, I am fine with that.

We need two of them, because you may use the utility to produce a standalone report which has to keep the proper hierarchy of headings. Plus for the mkdocs I skip the top level heading