Sean Wheeler

Needs testing in new version before release.

PlatyPS doesn't include possible values in the SYNTAX blocks. Nor should it. The markdown should only contain the raw syntax. It produces the same syntax block you get from `Get-Command`....

This is fixed in Microsoft.PowerShell.PlatyPS v1

Right, the is not fixed in v0.14.2. We haven't released Microsoft.PowerShell.PlatyPS v1 to the public yet. It is still in development.

This is fixed in Microsoft.PowerShell.PlatyPS v1 for examples. We don't add a language to the syntax blocks because they are not `powershell` language. The syntax highlighting does not apply to...

Based on review of the conversation, it appears that this is by design. Wait for Microsoft.PowerShell.PlatyPS v1 and see if you think there needs to be a change in what...

This need further investigation. This may be a problem with the interaction with the PowerShell help system (`Get-Help`). Need to test this for GA and decide.

Restested with Microsoft.PowerShell.PlatyPS v1. It's not importing the comment-based help properly for examples. Get-Help is also altering the propmt text in the example, but v1 is skipping the code entirely....

This is by design. The LINKS section expects links.

`New-MarkdownAboutHelp` is not supported in Microsoft.PowerShell.PlatyPS. The PowerShell help system (`Get-Help`) only supports these files as unstructured plain text.