ConvertFrom-Markdown

  • Referens
Modul:
Microsoft.PowerShell.Utility

Konvertera innehållet i en sträng eller en fil till ett MarkdownInfo- objekt.

Syntax

ConvertFrom-Markdown
                [-Path] <String[]>
                [-AsVT100EncodedString]
                [<CommonParameters>]
ConvertFrom-Markdown
                -LiteralPath <String[]>
                [-AsVT100EncodedString]
                [<CommonParameters>]
ConvertFrom-Markdown
                -InputObject <PSObject>
                [-AsVT100EncodedString]
                [<CommonParameters>]

Description

Den här cmdleten konverterar det angivna innehållet till en MarkdownInfo. När en filsökväg har angetts för parametern Path konverteras innehållet i filen. Utdataobjektet har tre egenskaper:

  • Egenskapen Token har det konverterade objektets abstrakta syntaxträd (AST)
  • Egenskapen Html har HTML-konvertering av angivna indata
  • Egenskapen VT100EncodedString har den konverterade strängen med ANSI-undantagssekvenser (VT100) om parametern AsVT100EncodedString har angetts

Den här cmdleten introducerades i PowerShell 6.1.

Exempel

Exempel 1: Konvertera en fil som innehåller Markdown-innehåll till HTML

ConvertFrom-Markdown -Path .\README.md

Objektet MarkdownInfo returneras. Egenskapen Tokens har AST för det konverterade innehållet i README.md-filen. Egenskapen Html har HTML-konverterat innehåll i README.md-filen.

Exempel 2: Konvertera en fil som innehåller Markdown-innehåll till en VT100-kodad sträng

ConvertFrom-Markdown -Path .\README.md -AsVT100EncodedString

Objektet MarkdownInfo returneras. Egenskapen Tokens har AST för det konverterade innehållet i README.md-filen. Egenskapen VT100EncodedString har VT100-kodad sträng konverterat innehåll i README.md-filen.

Exempel 3: Konvertera indataobjekt som innehåller Markdown-innehåll till en VT100-kodad sträng

Get-Item .\README.md | ConvertFrom-Markdown -AsVT100EncodedString

Objektet MarkdownInfo returneras. Objektet FileInfo från Get-Item konverteras till en VT100-kodad sträng. Egenskapen Tokens har AST för det konverterade innehållet i README.md-filen. Egenskapen VT100EncodedString har VT100-kodad sträng konverterat innehåll i README.md-filen.

Exempel 4: Konvertera en sträng som innehåller Markdown-innehåll till en VT100-kodad sträng

"**Bold text**" | ConvertFrom-Markdown -AsVT100EncodedString

Objektet MarkdownInfo returneras. Den angivna strängen **Bold text** konverteras till en VT100-kodad sträng och är tillgänglig i egenskapen VT100EncodedString.

Parametrar

-AsVT100EncodedString

Anger om utdata ska kodas som en sträng med VT100-undantagskoder.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-InputObject

Anger det objekt som ska konverteras. När ett objekt av typen System.String anges konverteras strängen. När ett objekt av typen System.IO.FileInfo anges konverteras innehållet i filen som anges av objektet. Objekt av någon annan typ resulterar i ett fel.

Typ:PSObject
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-LiteralPath

Anger en sökväg till filen som ska konverteras.

Typ:String[]
Alias:PSPath, LP
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Path

Anger en sökväg till filen som ska konverteras.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:True

Indata

PSObject

Utdata

Microsoft.PowerShell.MarkdownRender.MarkdownInfo