Convert-Ps1ToHtml

Script: Convert-Ps1ToHtml.ps1 (keep a copy with your other ops scripts; often under C:\Scripts or the Chief of Staff working folder)
Requires: PowerShell 7+ (#requires -Version 7.0)

Turns a PowerShell .ps1 into a self-contained HTML file with VS Code Dark+-style syntax highlighting. Useful for sharing script source in a browser, attaching readable HTML to docs, or publishing a pretty copy next to a usage page.

Parameters

Name	Required	Default	Purpose
`Path`	Yes	—	Source script path (`.ps1` or other text PowerShell file)
`OutFile`	No	Same folder/name as `Path` with `.html`	Destination HTML path
`Title`	No	Source file name	`<title>` and heading text
`LineNumbers`	No	`$true`	Show line-number gutter; pass `-LineNumbers:$false` to hide

Examples

# Basic: write Script.html next to Script.ps1
.\Convert-Ps1ToHtml.ps1 -Path C:\Scripts\SQLTool.ps1

# Custom output and title
.\Convert-Ps1ToHtml.ps1 -Path .\SQLTool.ps1 -OutFile .\SQLTool-source.html -Title 'SQLTool source'

# No line numbers
.\Convert-Ps1ToHtml.ps1 -Path .\SQLTool.ps1 -LineNumbers:$false

What you get

Single HTML file (inline CSS) — no extra assets
Token colors inspired by VS Code Dark+
Optional sticky header with the title
Optional line-number gutter

Notes

Uses [System.Management.Automation.PSParser]::Tokenize (or the PSParser API available in the host) — large scripts are fine; very huge files may take a moment.
Output is for reading/sharing, not for executing. Keep the real .ps1 as the source of truth.
Pair with site docs (like this page) when you want both usage narrative and a highlighted source dump.
Run under PowerShell 7+; Windows PowerShell 5.1 is not the target host for this script.

Convert-Ps1ToHtml

Parameters

Examples

What you get

Notes

See also