Show-Markdown
Shows a Markdown file or string in the console in a friendly way using VT100 escape sequences or in a browser using HTML.
Синтаксис
Path (по умолчанию)
Show-Markdown
[-Path] <String[]>
[-UseBrowser]
[<CommonParameters>]
InputObject
Show-Markdown
-InputObject <PSObject>
[-UseBrowser]
[<CommonParameters>]
LiteralPath
Show-Markdown
-LiteralPath <String[]>
[-UseBrowser]
[<CommonParameters>]
Описание
The Show-Markdown cmdlet is used to render Markdown in a human readable format either in a
terminal or in a browser.
Show-Markdown can return a string that includes the VT100 escape sequences which the terminal
renders (if it supports VT100 escape sequences). This is primarily used for viewing Markdown files
in a terminal. You can also get this string via the ConvertFrom-Markdown by specifying the
AsVT100EncodedString parameter.
Show-Markdown also has the ability to open a browser and show you a rendered version of the
Markdown. It renders the Markdown by turning it into HTML and opening the HTML file in your default
browser.
You can change how Show-Markdown renders Markdown in a terminal by using Set-MarkdownOption.
This cmdlet was introduced in PowerShell 6.1.
Примеры
Example 1: Simple example specifying a path
Show-Markdown -Path ./README.md
Example 2: Simple example specifying a string
@"
# Show-Markdown
## Markdown
You can now interact with Markdown via PowerShell!
*stars*
__underlines__
"@ | Show-Markdown
Example 2: Opening Markdown in a browser
Show-Markdown -Path ./README.md -UseBrowser
Параметры
-InputObject
A Markdown string that will be shown in the terminal. If you do not pass in a supported format,
Show-Markdown will emit an error.
Свойства параметра
| Тип: | PSObject |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
InputObject
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-LiteralPath
Specifies the path to a Markdown file. Unlike the Path parameter, the value of LiteralPath is used exactly as it is typed. No characters are interpreted as wildcards. If the path includes escape characters, enclose it in single quotation marks. Single quotation marks tell PowerShell not to interpret any characters as escape sequences.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
| Aliases: | PSPath, LP |
Наборы параметров
LiteralPath
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Path
Specifies the path to a Markdown file to be rendered.
Свойства параметра
| Тип: | String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | True |
| DontShow: | False |
Наборы параметров
Path
| Position: | 0 |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-UseBrowser
Compiles the Markdown input as HTML and opens it in your default browser.
Свойства параметра
| Тип: | SwitchParameter |
| Default value: | False |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
