diff --git a/content/zh-cn/docs/test.md b/content/zh-cn/docs/test.md index aa1553a9d2..e16d2fe3d0 100644 --- a/content/zh-cn/docs/test.md +++ b/content/zh-cn/docs/test.md @@ -23,7 +23,52 @@ This page serves two purposes: ## Heading levels The above heading is an H2. The page title renders as an H1. The following -sections show H3-H6. +sections show H3 - H6. +--> +## 标题级别 {#heading-levels} + +上面的标题是 H2 级别。页面标题(Title)会渲染为 H1。以下各节分别展示 H3-H6 +的渲染结果。 + + +```markdown +### H3 + +此处为 H3 节内容。 + +#### H4 + +此处为 H4 节内容。 + +##### H5 + +此处为 H5 节内容。 + +###### H6 + +此处为 H6 节内容。 +``` + + -## 标题级别 {#heading-levels} - -上面的标题是 H2 级别。页面标题(Title)会渲染为 H1。以下各节分别展示 H3-H6 -的渲染结果。 +渲染后的结果为: ### H3 @@ -81,10 +123,41 @@ culpa qui officia deserunt mollit anim id est laborum. ### 内联文本风格 {#inline-text-styles} +你可以在 Markdown 中如下使用不同的文本风格: + +```markdown +- **粗体字** +- _斜体字_ +- ***粗斜体字*** +- ~~删除线~~ +- 下划线 +- _带下划线的斜体_ +- ***带下划线的粗斜体*** +- `monospace text` <- 等宽字体 +- **`monospace bold`** <- 粗等宽字体 +``` + +渲染后的结果为: + - **粗体字** - _斜体字_ - ***粗斜体字*** @@ -133,6 +208,33 @@ Markdown 在如何处理列表方面没有严格的规则。在我们从 Jekyll +### 项目符号列表 {#bullet-lists} + +你可以在 Markdown 中如下添加项目符号列表: + +```markdown +- 此为列表条目。 +* 此为另一列表条目,位于同一列表中。 +- 你可以将 `-` 和 `*` 混合使用。 + - 要开始子列表,缩进两个空格。 + - 这是另一个子子条目。进一步多缩进两个空格。 + - 另一个子条目。 +``` + + -### 项目符号列表 {#bullet-lists} +渲染后的结果为: - 此为列表条目。 * 此为另一列表条目,位于同一列表中。 @@ -149,9 +251,9 @@ Markdown 在如何处理列表方面没有严格的规则。在我们从 Jekyll - 这是另一个子子条目。进一步多缩进两个空格。 - 另一个子条目。 - - +另外, + - 这是一个新的列表。使用 Hugo 时,你需要用一行 HTML 注释将两个紧挨着的列表分开。 **这里的 HTML 注释需要按左侧顶边对齐。** - 项目符号列表可以中包含文字段落或块元素。 @@ -194,17 +298,17 @@ Markdown 在如何处理列表方面没有严格的规则。在我们从 Jekyll ### 编号列表 {#numbered-lists} -1. 此为列表条目 -1. 此为列表中的第二个条目。在 Markdown 源码中所给的编号数字与最终输出的数字 - 可能不同。建议在紧凑列表中编号都使用 1。如果条目之间有其他内容(比如注释 - 掉的英文)存在,则需要显式给出编号。 +1. 此为列表条目。 +1. 此为列表中的第二个条目。在 Markdown 源码中所给的编号数字与最终输出的数字可能不同。 + 建议在紧凑列表中编号都使用 1。 + 如果条目之间有其他内容(比如注释掉的英文)存在,则需要显式给出编号。 {{}} 反引号标记代码段的方式有以下优点: -- 这种方式几乎总是能正确工作 -- 在查看源代码时,内容相对紧凑 -- 允许你指定代码块的编程语言,以便启用语法加亮 +- 这种方式几乎总是能正确工作。 +- 在查看源代码时,内容相对紧凑。 +- 允许你指定代码块的编程语言,以便启用语法加亮。 - 代码段的结束位置有明确标记。有时候,采用缩进空格的方式会使得一些对空格很敏感的语言(如 Python、YAML)很难处理。 +渲染后的结果为: + ![pencil icon](/images/pencil.png) -{{< figure src="/images/pencil.png" title="铅笔图标" caption="用来展示 figure 短代码的图片" width="200px" >}} +
+ {{< figure src="/images/pencil.png" title="铅笔图标" caption="用来展示 figure 短代码的图片" width="200px" >}} +
即使你不想使用 figure 短代码,图片也可以展示为链接。这里,铅笔图标指向 Kubernetes 网站。外层的方括号将整个 image 标签封装起来,链接目标在末尾的圆括号之间给出。 + +```markdown +[![铅笔图标](/images/pencil.png)](https://kubernetes.io) +``` + +渲染后的结果为: + [![铅笔图标](/images/pencil.png)](https://kubernetes.io) + 你也可以使用 HTML 来嵌入图片,不过这种方式是不推荐的。 + +```markdown +铅笔图标 +``` + +渲染后的结果为: + 铅笔图标 +```html + + + + + + + + + + + + + +
标题单元格 1标题单元格 2
内容单元格 1内容单元格 2
+``` + + +渲染后的结果为: + @@ -670,16 +854,7 @@ The Mermaid JS version is specified in [/layouts/partials/head.html](https://git Mermaid JS 版本在 [/layouts/partials/head.html](https://github.com/kubernetes/website/blob/main/layouts/partials/head.html) 中设置。 - -``` +```markdown {{}} graph TD; 甲-->乙; @@ -692,7 +867,7 @@ graph TD; -会产生: +渲染后的结果为: - -``` +```markdown {{}} sequenceDiagram 张三 ->> 李四: 李四,锄禾日当午? @@ -744,7 +918,7 @@ sequenceDiagram -会产生: +渲染后的结果为: