Condividi tramite

ConvertFrom-Markdown

  • Riferimento
Modulo:
Microsoft.PowerShell.Utility

Convertire il contenuto di una stringa o di un file in un oggetto MarkdownInfo.

Sintassi

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

Descrizione

Questo cmdlet converte il contenuto specificato in un MarkdownInfo. Quando viene specificato un percorso di file per il parametro Path, il contenuto del file viene convertito. L'oggetto di output ha tre proprietà:

  • La proprietà token dispone dell'albero della sintassi astratta (AST) dell'oggetto convertito
  • La proprietà html ha la conversione HTML dell'input specificato
  • La proprietà VT100EncodedString ha la stringa convertita con sequenze di escape ANSI (VT100) se è stato specificato il parametro AsVT100EncodedString

Questo cmdlet è stato introdotto in PowerShell 6.1.

Esempio

Esempio 1: Convertire un file contenente contenuto Markdown in HTML

ConvertFrom-Markdown -Path .\README.md

Viene restituito l'oggetto MarkdownInfo. La proprietà token di dispone dell'AST del contenuto convertito del file README.md. La proprietà html ha il contenuto convertito HTML del file di README.md.

Esempio 2: Convertire un file contenente contenuto Markdown in una stringa con codifica VT100

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

Viene restituito l'oggetto MarkdownInfo. La proprietà token di dispone dell'AST del contenuto convertito del file README.md. La proprietà VT100EncodedString ha il contenuto convertito della stringa con codifica VT100 del file di README.md.

Esempio 3: Convertire l'oggetto di input contenente il contenuto Markdown in una stringa con codifica VT100

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

Viene restituito l'oggetto MarkdownInfo. L'oggetto FileInfo da Get-Item viene convertito in una stringa con codifica VT100. La proprietà token di dispone dell'AST del contenuto convertito del file README.md. La proprietà VT100EncodedString ha il contenuto convertito della stringa con codifica VT100 del file di README.md.

Esempio 4: Convertire una stringa contenente contenuto Markdown in una stringa con codifica VT100

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

Viene restituito l'oggetto MarkdownInfo. La stringa specificata **Bold text** viene convertita in una stringa con codifica VT100 ed è disponibile in proprietà VT100EncodedString.

Parametri

-AsVT100EncodedString

Specifica se l'output deve essere codificato come stringa con codici di escape VT100.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Specifica l'oggetto da convertire. Quando viene specificato un oggetto di tipo system.String, la stringa viene convertita. Quando viene specificato un oggetto di tipo System.IO.FileInfo, il contenuto del file specificato dall'oggetto viene convertito. Gli oggetti di qualsiasi altro tipo generano un errore.

Tipo:PSObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-LiteralPath

Specifica un percorso del file da convertire.

Tipo:String[]
Alias:PSPath, LP
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Path

Specifica un percorso del file da convertire.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:True

Input

PSObject

Output

Microsoft.PowerShell.MarkdownRender.MarkdownInfo