共用方式為

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>]

Description

Show-Markdown Cmdlet 可用來以終端機或瀏覽器中的人類可讀取格式轉譯 Markdown。

Show-Markdown 可以傳回字串，其中包含終端機轉譯的 VT100 逸出序列（如果支援 VT100 逸出序列）。 這主要用於在終端機中檢視 Markdown 檔案。 您也可以透過 ConvertFrom-Markdown 取得此字串，方法是指定 AsVT100EncodedString 參數。

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