Merge-MarkdownHelp munges multiple syntax blocks together

[chrisda]

Steps to reproduce

1. Take existing markdown files not created by platyPS for Exchange 2010, 2013, and 2016 (see attached).
2. Run Merge-MarkdownHelp -ExplicitApplicableIfAll -Path "InPath1","InPath2","InPath3" -OutputPath "OutPath"

Expected behavior

Existing syntax blocks are preserved/compared using merge markers

Actual behavior

Existing syntax blocks are combined into one big block containing mutually exclusive parameters (see attached)

Environment data

v0.9.0

Add-ADPermission2016.txt Add-ADPermissionMerged.txt Add-ADPermission2010.txt Add-ADPermission2013.txt

[vors]

Thank you for the report! I need to refresh my memory about it, I think it was one of the design trade-offs I had to make, in order to get it working. The SYNTAX block is a by-product of the PARAMETERS block. In other words, even if we just merge it, on the next Update-Markdown it would be overridden.