Get-MarkdownMetadata

参考

模块:: platyPS

从 markdown 文件的标头获取元数据。

语法

Get-MarkdownMetadata
   -Path <String[]>
   [<CommonParameters>]

Get-MarkdownMetadata
   -Markdown <String>
   [<CommonParameters>]

说明

Get-MarkdownMetadata cmdlet 从 PlatyPS 支持的 markdown 文件的标头获取元数据。该命令将元数据作为哈希表返回。

PlatyPS 将 markdown 文件的标头块中的元数据存储为字符串的键值对。默认情况下，PlatyPS 存储帮助文件名和 Markdown 架构版本。

元数据部分可以包含用于外部工具的用户提供的值。 New-ExternalHelp cmdlet 将忽略此元数据。

示例

示例 1：从文件获取元数据

PS C:\> Get-MarkdownMetadata -Path ".\docs\Get-MarkdownMetadata.md"

Key                Value
---                -----
external help file platyPS-help.xml
schema             2.0.0

此命令从 markdown 文件检索元数据。

示例 2：从 markdown 字符串获取元数据

PS C:\> $Markdown = Get-Content -Path ".\docs\Get-MarkdownMetadata.md" -Raw
PS C:\> Get-MarkdownMetadata -Markdown $Markdown

Key                Value
---                -----
external help file platyPS-help.xml
schema             2.0.0

第一个命令获取文件的内容，并将其存储在 $Markdown 变量中。

第二个命令从$Metadata中的字符串中检索元数据。

示例 3：从文件夹中的所有文件获取元数据

PS C:\> Get-MarkdownMetadata -Path ".\docs"

Key                Value
---                -----
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0
external help file platyPS-help.xml
schema             2.0.0

此命令从 .\docs 文件夹中的每个 markdown 文件获取元数据。

参数

-Markdown

指定包含 markdown 格式文本的字符串。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Path

指定 markdown 文件或文件夹的路径数组。

类型:	String[]
Position:	Named
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	True

输入

String[]

可以通过管道将路径数组传递给此 cmdlet。

输出

Dictionary[String, String]

该 cmdlet 返回 Dictionary[String, String] 对象。字典包含 markdown 元数据块中找到的键值对。