Markdown 如何在标记中列出键/值对

有没有一种方法可以编写键/值对列表

我试过这个：

+ key1: value1
+ key2: value2
+ key3: value3

但是结果对我来说不是很清楚

我也试过桌子：

|    |      |
|----|------|
|key1|value1|
|key2|value2|
|key3|value3|

---

但是，表格不是用于键/值列表的（例如，我不得不将标题行留空，这听起来很难听。）

答案将在很大程度上取决于降价风格和您使用的处理器。常规标记，尽管它确实支持内联HTML

和两个支持定义列表：

key1
: value 1

key2
: value 2

如果您没有使用支持定义列表的标记版本，则可以手动添加HTML

、

和

标记。当然，所使用的样式表将影响它们的显示。堆栈溢出将它们显示为基本上没有项目符号的无序列表，这不是很有用

或者，您可以使用常规列表并用四个空格重新缩进值，例如

* key1
    * value1
* key2
    * value2

您可以使用内联粗体或斜体从视觉上区分键和值，例如

* **key1**: value1
* **key2**: value2

最后，正如您在问题中所建议的，如果您的Markdown版本支持，您可以使用表。

GitHub风格的Markdown。它指示在原始HTML中执行此操作：

<dl>
    <dt>Definition list</dt>
    <dd>Is something people use sometimes.</dd>

    <dt>Markdown in HTML</dt>
    <dd>Does *not* work **very** well. Use HTML <em>tags</em>.</dd>
</dl>

定义列表
是人们有时使用的东西。
HTML中的标记
*不*工作**很**好。使用HTML标记。

Github将一块键值对呈现为带有标题行的表，如果您用三个破折号将其隔开

--

:

呈现为：

---

请注意，此解析不属于。它被解析为一个YAML元数据块，正如post中所通知的那样。这种YAML元数据格式是由

---
layout: classic-docs
title: "Caching in CircleCI"
short-title: "Caching"
description: "Caching strategies to increase build speeds"
categories: [configuring-jobs]
order: 20
---