Show-Markdown

参考

模块:: Microsoft.PowerShell.Utility

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

语法

Show-Markdown
    [-Path] <String[]>
    [-UseBrowser]
    [<CommonParameters>]

Show-Markdown
    -InputObject <PSObject>
    [-UseBrowser]
    [<CommonParameters>]

Show-Markdown
    -LiteralPath <String[]>
    [-UseBrowser]
    [<CommonParameters>]

说明

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

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

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

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

此 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 将发出错误。

Type:	PSObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-LiteralPath

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

Type:	String[]
Aliases:	PSPath, LP
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

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

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

-UseBrowser

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

输入

PSObject

String[]

输出

String

ConvertFrom-Markdown

通过