Use the Markdown.types.ps1xml to generate a help file in Markdown

Help to MD

$help = Get-Help Get-Location

$help.Name.MarkdownHeader()

"Synopsis".MarkdownHeader(2)

$help.Synopsis

"Description".MarkdownHeader(2)

$help.description.text

"Syntax".MarkdownHeader(2)

$help.syntax | Foreach {
    ($help.syntax | out-string )-split "`n" | foreach {"$_ <br />".MarkdownQuote()}
    
}

"Parameters".MarkdownHeader(2)

$help.parameters.parameter | foreach {
    $_.name.MarkdownHeader(3)    
    $_.description

    if ($_.aliases)
    {
        "Aliases".MarkdownHeader(4)
        $_.aliases | foreach {$_.MarkdownUL()}
    }
}

"Examples".MarkdownHeader(2)

$i = 1
$help.examples.example | foreach {
    
    "Example $i".MarkdownHeader(3)
    
    $_.code.MarkdownCodeBlock("powershell")
    
    $_.remarks
    $i++
}