diff --git a/docs/user/markdown.md b/docs/user/markdown.md index 18cb42c67f5ebe015a94d8ed650bb5d38cb267e2..e84732500c05966a3a791f4d4c696316a9c711f5 100644 --- a/docs/user/markdown.md +++ b/docs/user/markdown.md @@ -136,7 +136,7 @@ graph TD; ``` ```` -​```mermaid +```mermaid graph TD; A-->B; A-->C; @@ -163,7 +163,7 @@ end ``` ```` -​```mermaid +```mermaid graph TB SubGraph1 --> SubGraph1Flow subgraph "SubGraph 1 Flow" @@ -578,25 +578,25 @@ But let's throw in a tag. 上面的四个示例呈现为： -​```markdown +​``` var s = "JavaScript syntax highlighting"; alert(s); ``` -```markdown +``` def function(): #indenting works just fine in the fenced code block s = "Python syntax highlighting" print s ``` -```markdown +``` require 'redcarpet' markdown = Redcarpet.new("Hello World!") puts markdown.to_html ``` -```markdown +``` No language indicated, so no syntax highlighting. s = "There is no highlighting for this." But let's throw in a tag. @@ -608,7 +608,7 @@ But let's throw in a tag. 例如: -```markdown +``` Emphasis, aka italics, with *asterisks* or _underscores_ Strong emphasis, aka bold, with double **asterisks** or __underscores__. Combined emphasis with **asterisks and _underscores_**. @@ -648,7 +648,7 @@ do*this*and*do*that*and*another thing 参考标记可以使用字母和其他字符. 在解决[此错误](https://gitlab.com/gitlab-org/gitlab/-/issues/24423)之前，请避免在脚注标签名称中使用小写`w`或下划线（ `_` ）. -```markdown +``` A footnote reference tag looks like this: [^1] This reference tag is a mix of letters and numbers. [^footnote-42] [^1]: This is the text inside a footnote. @@ -713,7 +713,7 @@ GFM 扩展了标准 Markdown 标准，以便所有 Markdown 呈现的标头都 使用三个或多个连字符，星号或下划线来创建水平尺非常简单： -```markdown +``` Three or more hyphens, --- asterisks, @@ -726,7 +726,7 @@ ___ 例如: -```markdown +``` Inline-style (hover to see title text): ![alt text](img/markdown_logo.png "Title Text") Reference-style (hover to see title text): @@ -764,7 +764,7 @@ Here's a sample audio clip: 有关允许的 HTML 标记和属性的列表，请参见 HTML :: Pipeline 的[SanitizationFilter](https://github.com/jch/html-pipeline/blob/v2.12.3/lib/html/pipeline/sanitization_filter.rb#L42)类的文档. 除了默认`SanitizationFilter`允许列表，GitLab 允许`span` ， `abbr` ， `details`和`summary`元素。 -```markdown +```
Definition list
Is something people use sometimes.
@@ -775,7 +775,7 @@ Here's a sample audio clip: 仍然可以在 HTML 标记内使用 Markdown，但前提是包含 Markdown 的行分为各自的行: -```markdown +```
Markdown in HTML
Does *not* work **very** well. HTML tags will work, in most cases.
@@ -792,7 +792,7 @@ Here's a sample audio clip: 可以使用 HTML 的[`
`](https://s0developer0mozilla0org.icopy.site/en-US/docs/Web/HTML/Element/details)和[``](https://s0developer0mozilla0org.icopy.site/en-US/docs/Web/HTML/Element/summary)标记折叠内容. 这对于折叠长日志特别有用，因为它们占用更少的屏幕空间。 -```markdown +```

Click this to collapse/fold. @@ -810,7 +810,7 @@ These details will remain hidden until expanded. 请记住，在`
`标记之后和`
`标记之前留空行，如示例所示： -````markdown +````
Click this to collapse/fold. These details _will_ remain **hidden** until expanded. @@ -824,7 +824,7 @@ PASTE LOGS HERE 如果先前的文本以两个换行符结尾，则会插入一个换行符（将开始一个新的段落），例如当您连续两次按`Enter 键`时. 如果仅使用一个换行符（ `按`一次`Enter 键` ），则下一个句子将成为同一段落的一部分. 如果要避免长行换行并使它们易于编辑，这很有用： -```markdown +``` Here's a line for us to start with. This longer line is separated from the one above by two newlines, so it will be a *separate paragraph*. @@ -843,7 +843,7 @@ GFM 在[处理段落和换行符方面](https://spec.commonmark.org/current/)遵 如果您需要对换行符或换行符进行更多控制，则可以通过以反斜杠或两个或多个空格结束一行来添加单个换行符，连续两个换行符将创建一个新的段落，中间有一个空行： -```markdwon +``` First paragraph. Another line in the same paragraph. A third line in the same paragraph, but this time ending with two spaces.{space}{space} @@ -858,7 +858,7 @@ A new line due to the previous backslash. 有两种创建链接的方法，即内联样式和引用样式： -```markdown +``` - This is an [inline-style link](https://www.google.com) - This is a [link to a repository file in the same directory](index.md) - This is a [relative link to a readme one directory higher](../README.md) @@ -888,7 +888,7 @@ Some text to show that the reference links can follow later. GFM 将自动为您添加到文档中的 URL 设置链接： -```markdown +``` - https://www.google.com - https://www.google.com - ftp://ftp.us.debian.org/debian/ @@ -912,7 +912,7 @@ GFM 将自动为您添加到文档中的 URL 设置链接： 例如: -```markdown +``` 1. First ordered list item 2. Another item - Unordered sub-list. @@ -932,7 +932,7 @@ GFM 将自动为您添加到文档中的 URL 设置链接： 对于无序列表，请在无序列表的每一行的开头添加`-` ， `*`或`+` ，然后加上一个空格，但是您不能混合使用它们。 -```markdown +``` Unordered lists can: - use - minuses @@ -952,7 +952,7 @@ They can even: 例如: -```markdown +``` 1. First ordered list item Second paragraph of first item. @@ -995,7 +995,7 @@ while the equation for the theory of relativity is E = mc2. 例如: -```markdown +``` | header 1 | header 2 | header 3 | | --- | ------ |---------:| | cell 1 | cell 2 | cell 3 | @@ -1007,7 +1007,7 @@ while the equation for the theory of relativity is E = mc2. **注意：** [在 GitLab 本身中](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#tables) ，标题始终在 Chrome 和 Firefox 中左对齐，并在 Safari 中居中。 -```markdown +``` | Left Aligned | Centered | Right Aligned | Left Aligned | Centered | Right Aligned | | :--- | :---: | ---: | :----------- | :------: | ------------: | | Cell 1 | Cell 2 | Cell 3 | Cell 4 | Cell 5 | Cell 6 |