Show-Markdown

使用 VT100 转义序列以友好方式在控制台中显示 Markdown 文件或字符串,或者使用 HTML 在浏览器中显示。

语法

Show-Markdown
    [-Path] <String[]>
    [-UseBrowser]
    [<CommonParameters>]
Show-Markdown
    -InputObject <PSObject>
    [-UseBrowser]
    [<CommonParameters>]
Show-Markdown
    -LiteralPath <String[]>
    [-UseBrowser]
    [<CommonParameters>]

说明

Show-Markdown cmdlet 用于在终端或浏览器中以人工可读格式呈现 Markdown。

Show-Markdown 可以返回一个字符串,其中包含终端呈现的 VT100 转义序列(如果支持 VT100 转义序列)。 这主要用于在终端中查看 Markdown 文件。 你还可以通过指定 AsVT100EncodedString 参数通过 ConvertFrom-Markdown 来获取此字符串。

Show-Markdown 还可以打开浏览器并显示 Markdown 的呈现版本。 它通过将 Markdown 转换为 HTML 并在默认浏览器中打开 HTML 文件来呈现 Markdown。

你可以使用 Set-MarkdownOption 更改 Show-Markdown 在终端中呈现 Markdown 的方式。

此 cmdlet 在 PowerShell 6.1 中引入。

示例

示例 1:指定路径的简单示例

Show-Markdown -Path ./README.md

示例 2:指定字符串的简单示例

@"
# Show-Markdown

## Markdown

You can now interact with Markdown via PowerShell!

*stars*
__underlines__
"@ | Show-Markdown

示例 2:在浏览器中打开 Markdown

Show-Markdown -Path ./README.md -UseBrowser

参数

-InputObject

将在终端中显示的 Markdown 字符串。 如果未以受支持的格式传递,Show-Markdown 将发出错误。

类型:PSObject
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-LiteralPath

指定 Markdown 文件的路径。 与 Path 参数不同,LiteralPath 的值严格按照所键入的形式使用。 不会将任何字符解释为通配符。 如果路径包括转义符,请将其括在单引号中。 单引号告知 PowerShell 不要将任何字符解释为转义序列。

类型:String[]
别名:PSPath, LP
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-Path

指定要呈现的 Markdown 文件的路径。

类型:String[]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:True

-UseBrowser

将 Markdown 输入编译为 HTML,并在默认浏览器中打开它。

类型:SwitchParameter
Position:Named
默认值:False
必需:False
接受管道输入:False
接受通配符:False

输入

PSObject

String[]

输出

String