ConvertFrom-Markdown

Referencia

Módulo:: Microsoft.PowerShell.Utility

Convierta el contenido de una cadena o un archivo en un objeto MarkdownInfo.

Sintaxis

ConvertFrom-Markdown
                [-Path] <String[]>
                [-AsVT100EncodedString]
                [<CommonParameters>]

ConvertFrom-Markdown
                -LiteralPath <String[]>
                [-AsVT100EncodedString]
                [<CommonParameters>]

ConvertFrom-Markdown
                -InputObject <PSObject>
                [-AsVT100EncodedString]
                [<CommonParameters>]

Description

Este cmdlet convierte el contenido especificado en un MarkdownInfo. Cuando se especifica una ruta de acceso de archivo para el parámetro Path, se convierte el contenido del archivo. El objeto de salida tiene tres propiedades:

La propiedad token de tiene el árbol de sintaxis abstracta (AST) del objeto convertido.
La propiedad html tiene la conversión HTML de la entrada especificada.
La propiedad VT100EncodedString tiene la cadena convertida con secuencias de escape ANSI (VT100) si se especificó el parámetro AsVT100EncodedString

Este cmdlet se introdujo en PowerShell 6.1.

Ejemplos

Ejemplo 1: Conversión de un archivo que contiene contenido de Markdown en HTML

ConvertFrom-Markdown -Path .\README.md

Se devuelve el objeto MarkdownInfo. La propiedad tokens tiene el AST del contenido convertido del archivo README.md. La propiedad html tiene el contenido convertido html del archivo README.md.

Ejemplo 2: Conversión de un archivo que contiene contenido de Markdown a una cadena codificada en VT100

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

Se devuelve el objeto MarkdownInfo. La propiedad tokens tiene el AST del contenido convertido del archivo README.md. La propiedad VT100EncodedString de tiene el contenido convertido de cadena con codificación VT100 del archivo README.md.

Ejemplo 3: Convertir el objeto de entrada que contiene contenido de Markdown a una cadena codificada en VT100

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

Se devuelve el objeto MarkdownInfo. El objeto FileInfo de de Get-Item se convierte en una cadena codificada en VT100. La propiedad tokens tiene el AST del contenido convertido del archivo README.md. La propiedad VT100EncodedString de tiene el contenido convertido de cadena con codificación VT100 del archivo README.md.

Ejemplo 4: Convertir una cadena que contiene contenido de Markdown en una cadena codificada en VT100

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

Se devuelve el objeto MarkdownInfo. La cadena especificada **Bold text** se convierte en una cadena codificada en VT100 y está disponible en propiedad VT100EncodedString.

Parámetros

-AsVT100EncodedString

Especifica si la salida se debe codificar como una cadena con códigos de escape VT100.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-InputObject

Especifica el objeto que se va a convertir. Cuando se especifica un objeto de tipo System.String, se convierte la cadena. Cuando se especifica un objeto de tipo System.IO.FileInfo, se convierte el contenido del archivo especificado por el objeto. Los objetos de cualquier otro tipo producen un error.

Tipo:	PSObject
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	False

-LiteralPath

Especifica una ruta de acceso al archivo que se va a convertir.

Tipo:	String[]
Alias:	PSPath, LP
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	False

-Path