A PowerShell module for authoring external help files in Markdown and converting them to MAML format.
PlatyPS is a PowerShell module developed by Microsoft that simplifies the creation of PowerShell help content. It allows authors to write documentation in Markdown, a widely supported and easier-to-use format, and converts it to the Microsoft Assistance Markup Language (MAML) XML format used by PowerShell's `Get-Help` command and Microsoft Learn documentation.
PowerShell module developers and technical writers who need to create or maintain help documentation for PowerShell cmdlets, especially those contributing to Microsoft's official PowerShell documentation on Microsoft Learn.
Developers choose PlatyPS because it replaces complex XML authoring with Markdown, leveraging industry-standard tools like Visual Studio Code, and provides high-performance processing with accurate cmdlet representation through a C# rewrite using the Markdig library.
Write PowerShell External Help in Markdown
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Allows writing help in Markdown instead of complex MAML XML, supported by editors like Visual Studio Code, making documentation more accessible and maintainable for developers.
Rebuilt in C# with the Markdig library, it processes thousands of Markdown files in seconds, enabling efficient handling of large PowerShell codebases as highlighted in the README.
Provides more precise descriptions of PowerShell cmdlets and parameters, including previously unavailable information, ensuring help content aligns closely with actual cmdlet behavior.
Creates a manipulatable object model of help files, enabling complex operations through cmdlet chaining for advanced automation and integration into scripts.
Contributing or building from source requires specific prerequisites like PS7, .NET 8 SDK, and Pester 4.x (not 5.x), adding overhead for developers who want to customize or extend the tool.
The project maintains a legacy v1 branch that is no longer actively maintained, which can cause confusion and migration challenges for users of older versions.
Exclusively designed for PowerShell help documentation, making it unsuitable for projects that need cross-platform or multi-language documentation solutions.