แปลงจากมาร์กดาวน์ (Microsoft.PowerShell.Utility)

ConvertFrom-Markdown

โมดูล :: Microsoft.PowerShell.Utility

แปลงเนื้อหาของสตริงหรือไฟล์เป็นวัตถุ MarkdownInfo

ไวยากรณ์

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

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

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

คำอธิบาย

cmdlet นี้แปลงเนื้อหาที่ระบุเป็น MarkdownInfo เมื่อมีการระบุเส้นทางของไฟล์สำหรับพารามิเตอร์ เส้นทาง เนื้อหาในไฟล์จะถูกแปลง วัตถุผลลัพธ์มีคุณสมบัติสามประการ:

คุณสมบัติ โทเค็น มีแผนผังไวยากรณ์นามธรรม (AST) ของวัตถุที่แปลงแล้ว
คุณสมบัติ Html มีการแปลง HTML ของอินพุตที่ระบุ
คุณสมบัติ VT100EncodedString มีสตริงที่แปลงแล้วด้วยลำดับหลีก ANSI (VT100) หากมีการระบุพารามิเตอร์ AsVT100EncodedString

cmdlet นี้ถูกนำมาใช้ใน PowerShell 6.1

ตัวอย่าง

ตัวอย่างที่ 1: แปลงไฟล์ที่มีเนื้อหา Markdown เป็น HTML

ConvertFrom-Markdown -Path .\README.md

ออบเจ็กต์ MarkdownInfo ถูกส่งกลับ คุณสมบัติ โทเค็น มี AST ของเนื้อหาที่แปลงแล้วของไฟล์ README.md คุณสมบัติ Html มีเนื้อหาที่แปลงเป็น HTML ของไฟล์ README.md

ตัวอย่างที่ 2: แปลงไฟล์ที่มีเนื้อหา Markdown เป็นสตริงที่เข้ารหัส VT100

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

ออบเจ็กต์ MarkdownInfo ถูกส่งกลับ คุณสมบัติ โทเค็น มี AST ของเนื้อหาที่แปลงแล้วของไฟล์ README.md คุณสมบัติ VT100EncodedString มีเนื้อหาที่แปลงสตริงที่เข้ารหัส VT100 ของไฟล์ README.md

ตัวอย่างที่ 3: แปลงออบเจ็กต์อินพุตที่มีเนื้อหา Markdown เป็นสตริงที่เข้ารหัส VT100

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

ออบเจ็กต์ MarkdownInfo ถูกส่งกลับ ออบเจ็กต์ FileInfo จาก Get-Item จะถูกแปลงเป็นสตริงที่เข้ารหัส VT100 คุณสมบัติ โทเค็น มี AST ของเนื้อหาที่แปลงแล้วของไฟล์ README.md คุณสมบัติ VT100EncodedString มีเนื้อหาที่แปลงสตริงที่เข้ารหัส VT100 ของไฟล์ README.md

ตัวอย่างที่ 4: แปลงสตริงที่มีเนื้อหา Markdown เป็นสตริงที่เข้ารหัส VT100

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

ออบเจ็กต์ MarkdownInfo ถูกส่งกลับ สตริงที่ระบุ **ข้อความตัวหนา** จะถูกแปลงเป็นสตริงที่เข้ารหัส VT100 และมีอยู่ในคุณสมบัติ VT100EncodedString

พารามิเตอร์

-AsVT100EncodedString

ระบุว่าเอาต์พุตควรเข้ารหัสเป็นสตริงที่มีโค้ด Escape VT100 หรือไม่

พิมพ์ :: SwitchParameter
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: False
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-InputObject

ระบุวัตถุที่จะแปลง เมื่อมีการระบุออบเจ็กต์ประเภท System.String สตริงจะถูกแปลง เมื่อมีการระบุออบเจ็กต์ประเภท System.IO.FileInfo เนื้อหาของไฟล์ที่ระบุโดยออบเจ็กต์จะถูกแปลง ออบเจ็กต์ประเภทอื่นส่งผลให้เกิดข้อผิดพลาด

พิมพ์ :: PSObject
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: True
ยอมรับอินพุตไปป์ไลน์:: True
ยอมรับอักขระตัวแทน:: False

-LiteralPath

ระบุเส้นทางไปยังไฟล์ที่จะแปลง

พิมพ์ :: String[]
นามแฝง :: PSPath, LP
ตำแหน่ง:: ตั้งชื่อ
ค่าเริ่มต้น:: None
ที่จำเป็น:: True
ยอมรับอินพุตไปป์ไลน์:: False
ยอมรับอักขระตัวแทน:: False

-Path