🙏 Markdown output should include severity info.

[User396-lgtm]

Currently the markdown output includes the same info as the html output, with the exception of the "severity" of each test.

Currently MD output looks like this:

✅ CISA.MS.AAD.1.1: Legacy authentication SHALL be blocked.

I suggest something like this MD output:

✅ CISA.MS.AAD.1.1: Legacy authentication SHALL be blocked.

Severity: 🔴 High      Status: ✅ Passed

Note that html image tags doen't render when converting MD to docx. Thus I would say that emojis are preferred over image tags in MD output.

How will this feature enhance your project and further the project’s overall goals? Who will benefit from this feature (i.e. all users, the project team)?

This will bring mark down output into alignment with html output. It will significantly enhance use cases where MD is being converted to docx for formal security audits.

Describe alternatives you've considered

Additional context

[kij]

For the markdown output - aren't you also bothered that the tests are unsorted and not grouped?

With regard to docx, how do you convert? For pandoc an intermediate html step works.
pandoc TestResults.md --from markdown --to html | pandoc -t docx -f html -o test.docx

That said, I don't think we will ever get something that fits all shoes. Would an option to specify a custom Get-MtMarkdownReport-like parameter work for you?

Personally I use a modified version with grouping but without the summary, because that just pandoc's --toc

[User396-lgtm]

yeah, it would be optimal to be able to filter and sort and group, I would use Get-MtMarkdownReport -group "by severity" -filter "excluded skipped" -sort "by test collection" if it existed... but for now simply having severity info in MD would be a win.

I use pandoc to convert MD to docx using our corporate template as a reference.

[kij]

The approach I have is:

1. copy powershell/internal/Get-MtMarkdownReport.ps1 and powershell/assets/ReportTemplate.md to a local folder.

2. Modify Get-MtMarkdownReport.ps1 to read the correct Template, and adjust ordering/content to your needs.
   e.g add $details += "Severity: $($test.Severity)".

3. Dot source your local Get-MtMarkdownReport . ./Get-MtMarkdownReport.ps1

4. read the results $maesterResults = Get-Content -Path './test-results/TestResults-2025-10-27.json' -Raw | ConvertFrom-Json

5. Create the custom report Get-MtMarkdownReport -MaesterResults $maesterResults | Out-File -FilePath 'custom-report.md' -Encoding UTF8