Set-MarkdownOption
Ustawia kolory i style używane do renderowania zawartości języka Markdown w konsoli programu .
Składnia
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>]
Opis
Ustawia kolory i style używane do renderowania zawartości języka Markdown w konsoli programu . Te style są definiowane przy użyciu kodów ucieczki ANSI, które zmieniają kolor i styl renderowanego tekstu markdown.
Aby uzyskać więcej informacji na temat języka Markdown, zobacz witrynę internetową CommonMark .
Uwaga
Wartości ciągów używane w ustawieniach to znaki zgodne z znakiem ucieczki ([char]0x1B
) dla sekwencji ucieczki ANSI. Nie dołączaj znaku Ucieczka w ciągu. Aby uzyskać więcej informacji na temat działania kodów ucieczki ANSI, zobacz ANSI_escape_code.
Przykłady
Przykład 1 — przełączanie do motywu jasnego
W tym przykładzie jest wybierany motyw Jasny i wyświetla nową konfigurację przy użyciu parametru 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
Przykład 2 — dostosowywanie ustawień koloru i stylu
W tym przykładzie zmienia się kod ucieczki nagłówków języka Markdown. Domyślna konfiguracja nagłówków renderuje je jako podkreślony tekst różnych kolorów. Ta zmiana powoduje usunięcie stylu podkreśleń.
$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
Parametry
-BoldForegroundColor
Ustawia kolor pierwszego planu na potrzeby renderowania tekstu pogrubionego języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Code
Ustawia kolor bloków i zakresów kodu renderowania w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Header1Color
Ustawia kolor renderowania bloków Header1 w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Header2Color
Ustawia kolor renderowania bloków Header2 w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Header3Color
Ustawia kolor renderowania bloków Header3 w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Header4Color
Ustawia kolor renderowania bloków Header4 w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Header5Color
Ustawia kolor renderowania bloków Header5 w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Header6Color
Ustawia kolor renderowania bloków Header6 w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ImageAltTextForegroundColor
Ustawia kolor pierwszego planu na potrzeby renderowania alternatywnego tekstu elementu obrazu w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-InputObject
Obiekt PSMarkdownOptionInfo zawierający konfigurację do ustawienia.
Typ: | PSObject |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-ItalicsForegroundColor
Ustawia kolor pierwszego planu na potrzeby renderowania kursywy w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-LinkForegroundColor
Ustawia kolor pierwszego planu na potrzeby renderowania hiperlinków w tekście języka Markdown.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PassThru
Powoduje, że polecenie cmdlet zwraca obiekt PSMarkdownOptionInfo zawierający nową konfigurację.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Theme
Wybiera motyw zawierający wstępnie zdefiniowane ustawienia kolorów. Możliwe wartości to Ciemny i Jasny.
Typ: | String |
Dopuszczalne wartości: | Dark, Light |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Dane wyjściowe
Microsoft.PowerShell.MarkdownRender.PSMarkdownOptionInfo
Uwagi
Wartości ciągu używane do definiowania koloru i stylu muszą być zgodne z wyrażeniem ^\[*[0-9;]*?m{1}
regularnym .