Share via

Show-Markdown

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Mostra um arquivo Markdown ou string no console de forma amigável usando sequências de escape VT100 ou em um navegador usando HTML.

Syntax

Show-Markdown
    [-Path] <String[]>
    [-UseBrowser]
    [<CommonParameters>]
Show-Markdown
    -InputObject <PSObject>
    [-UseBrowser]
    [<CommonParameters>]
Show-Markdown
    -LiteralPath <String[]>
    [-UseBrowser]
    [<CommonParameters>]

Description

O Show-Markdown cmdlet é usado para renderizar Markdown em um formato legível por humanos em um terminal ou em um navegador.

Show-Markdown pode retornar uma cadeia de caracteres que inclui as sequências de escape VT100 que o terminal renderiza (se ele suportar sequências de escape VT100). Isso é usado principalmente para visualizar arquivos Markdown em um terminal. Você também pode obter essa cadeia de caracteres especificando ConvertFrom-Markdown o parâmetro AsVT100EncodedString .

Show-Markdown também tem a capacidade de abrir um navegador e mostrar-lhe uma versão renderizada do Markdown. Ele renderiza o Markdown transformando-o em HTML e abrindo o arquivo HTML em seu navegador padrão.

Você pode alterar como Show-Markdown renderiza Markdown em um terminal usando Set-MarkdownOption.

Este cmdlet foi introduzido no PowerShell 6.1.

Exemplos

Exemplo 1: Exemplo simples especificando um caminho

Show-Markdown -Path ./README.md

Exemplo 2: Exemplo simples especificando uma cadeia de caracteres

@"
# Show-Markdown

## Markdown

You can now interact with Markdown via PowerShell!

*stars*
__underlines__
"@ | Show-Markdown

Exemplo 2: Abrindo Markdown em um navegador

Show-Markdown -Path ./README.md -UseBrowser

Parâmetros

-InputObject

Uma string Markdown que será mostrada no terminal. Se você não passar em um formato suportado, Show-Markdown emitirá um erro.

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

-LiteralPath

Especifica o caminho para um arquivo Markdown. Ao contrário do parâmetro Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

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

-Path

Especifica o caminho para um arquivo Markdown a ser renderizado.

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

-UseBrowser

Compila a entrada Markdown como HTML e abre-a no seu navegador padrão.

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

Entradas

PSObject

String[]

Saídas

String