有没有办法在 Azure DevOps wiki 页面的 HTML 表中添加 Markdown 链接？答案

【问题标题】：Is there a way to add a Markdown link within an HTML Table in an Azure DevOps wiki page?有没有办法在 Azure DevOps wiki 页面的 HTML 表中添加 Markdown 链接？
【发布时间】：2021-11-11 14:51:58
【问题描述】：

我正在为 Azure DevOps wiki 页面创建一个 HTML 表格（我需要使用 HTML 表格而不是 Markdown 表格来进行正确的颜色格式设置）。在这个表中，我需要创建指向其他 wiki 页面的链接。 Markdown 中链接 wiki 页面的格式如下： [text to display](/parent-page/child-page)。但是，我不知道在不列出 URL 的情况下使用 HTML 标记的方法：<a href="absolute or relative URL">text to display</a>。我想避免链接 URL，因为我正在创建 wiki 页面，方法是使用脚本生成包含所有链接的 .md 文件，并且与 URL 链接需要使用页面 ID 号和其他信息，而不是只是 wiki 页面的名称，使过程更加困难。

我已经看到您可以在 Azure DevOps 中的 HTML 中嵌套 markdown，但您必须在 HTML 元素和 markdown 之间包含一个空行。但是，添加此空白行似乎会弄乱表中所有后续行的格式。下面是我在 Azure DevOps wiki 页面中的 HTML 表格的格式。

<table>
<tr>
<th>Table Header</th><th>Table Header</th>
</tr>
<tr>
<td>

[Other wiki page](/parent-page/child-page)
</td><td>Table cell 2</td>
</tr>
<tr>
<td>Table cell 3</td><td>Table cell 4</td>
</tr>
</table>

下面是我尝试基于上述 HTML 创建的表格示例，方法是在 Azure DevOps 中使用带有 Markdown 链接的 HTML 表格。

Table Header	Table Header
Other wiki page	Table cell 2
Table cell 3	Table cell 4

总之，有没有一种方法可以在不使用 URL 的情况下使用 /parent-page/child-page 格式创建 HTML 链接？如果没有，有没有办法在 Azure DevOps wiki 页面的 HTML 表格中使用 Markdown 链接，而不会弄乱表格格式？

谢谢

【问题讨论】：

标签： html azure-devops markdown

【解决方案1】：

您可以使用pandoc、"swiss-army knife" for converting "one markup format into another" 和SO links。

如果您提供--toc 参数，它可以在输出文档中自动生成目录。

如果您想在 Markdown 文件中输出，请使用以下内容： pandoc -s --toc input.md -o input_toc.md.

必须注意确保输出名称与输入文件名不同。

在我看到 XmlDocMarkdown 的几个地方推荐了这种替代解决方案。

从 .NET XML 文档 cmets 生成 Markdown 的控制台应用程序。

或者你总是可以选择Pandoc。使用库存转换，或为转换过程滚动您自己的自定义 LUA 过滤器。

【讨论】：