Set-MarkdownOption
设置用于在控制台中呈现 Markdown 内容的颜色和样式。
语法
Set-MarkdownOption
[-Header1Color <String>]
[-Header2Color <String>]
[-Header3Color <String>]
[-Header4Color <String>]
[-Header5Color <String>]
[-Header6Color <String>]
[-Code <String>]
[-ImageAltTextForegroundColor <String>]
[-LinkForegroundColor <String>]
[-ItalicsForegroundColor <String>]
[-BoldForegroundColor <String>]
[-PassThru]
[<CommonParameters>]
Set-MarkdownOption
[-PassThru]
-Theme <String>
[<CommonParameters>]
Set-MarkdownOption
[-PassThru]
[-InputObject] <PSObject>
[<CommonParameters>]
说明
设置用于在控制台中呈现 Markdown 内容的颜色和样式。 这些样式是使用 ANSI 转义代码定义的,可以更改所要呈现的 Markdown 文本的颜色和样式。
有关 Markdown 的详细信息,请参阅 CommonMark 网站。
注意
设置中使用的字符串值是 ANSI 转义序列的转义字符 ([char]0x1B
) 后面的字符。 请不要在字符串中包含转义字符。 有关 ANSI 转义代码如何工作的详细信息,请参阅 ANSI_escape_code。
示例
示例 1 - 切换到 Light 主题
此示例选择 Light 主题并使用 PassThru 参数显示新配置。
Set-MarkdownOption -Theme Light -PassThru
Header1 : [7m
Header2 : [4;33m
Header3 : [4;34m
Header4 : [4;35m
Header5 : [4;36m
Header6 : [4;30m
Code : [48;2;155;155;155;38;2;30;30;30m
Link : [4;38;5;117m
Image : [33m
EmphasisBold : [1m
EmphasisItalics : [36m
示例 2 - 自定义颜色和样式设置
此示例更改 Markdown 标头的转义代码。 标头的默认配置将其呈现为各种颜色的带下划线文本。 此项更改移除了下划线样式。
$mdOptions = Get-MarkdownOption
$mdOptions.Header2 = '[93m'
$mdOptions.Header3 = '[94m'
$mdOptions.Header4 = '[95m'
$mdOptions.Header5 = '[96m'
$mdOptions.Header6 = '[97m'
Set-MarkdownOption -InputObject $mdOptions -PassThru
Header1 : [7m
Header2 : [93m
Header3 : [94m
Header4 : [95m
Header5 : [96m
Header6 : [97m
Code : [48;2;155;155;155;38;2;30;30;31m
Link : [4;38;5;117m
Image : [33m
EmphasisBold : [1m
EmphasisItalics : [36m
参数
-BoldForegroundColor
设置用于呈现粗体 Markdown 文本的前景色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Code
设置用于在 Markdown 文本中呈现代码块和跨度的颜色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Header1Color
设置用于在 Markdown 文本中呈现 Header1 块的颜色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Header2Color
设置用于在 Markdown 文本中呈现 Header2 块的颜色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Header3Color
设置用于在 Markdown 文本中呈现 Header3 块的颜色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Header4Color
设置用于在 Markdown 文本中呈现 Header4 块的颜色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Header5Color
设置用于在 Markdown 文本中呈现 Header5 块的颜色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Header6Color
设置用于在 Markdown 文本中呈现 Header6 块的颜色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ImageAltTextForegroundColor
设置用于在 Markdown 文本中呈现图像元素替代文本的前景色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-InputObject
一个 PSMarkdownOptionInfo 对象,包含要设置的配置。
类型: | PSObject |
Position: | 0 |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-ItalicsForegroundColor
设置用于在 Markdown 文本中呈现斜体的前景色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-LinkForegroundColor
设置用于在 Markdown 文本中呈现超链接的前景色。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-PassThru
使 cmdlet 输出一个包含新配置的 PSMarkdownOptionInfo 对象。
类型: | SwitchParameter |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-Theme
选择一个包含预定义颜色设置的主题。 可能的值为 Dark 和 Light。
类型: | String |
接受的值: | Dark, Light |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
输入
输出
Microsoft.PowerShell.MarkdownRender.PSMarkdownOptionInfo
备注
用于定义颜色和样式的字符串值必须与正则表达式 ^\[*[0-9;]*?m{1}
匹配。