... | ... | @@ -80,7 +80,7 @@ GitLab 充分利用了标准(CommonMark)格式,但还包括对 GitLab 用 |
|
|
|
|
|
### Colors[](#colors "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#colors) .
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#colors) .
|
|
|
|
|
|
可以使用颜色标识呈现以 HEX,RGB 或 HSL 格式书写的颜色。
|
|
|
|
... | ... | @@ -179,7 +179,7 @@ end |
|
|
```
|
|
|
### Emoji[](#emoji "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#emoji) .
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#emoji) .
|
|
|
|
|
|
```
|
|
|
Sometimes you want to :monkey: around a bit and add some :star2: to your :speech_balloon:. Well we have a gift for you:
|
... | ... | @@ -253,7 +253,7 @@ $example = array( |
|
|
|
|
|
### 行内 diff[](#inline-diff "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#inline-diff) 。
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#inline-diff) 。
|
|
|
|
|
|
使用内联 diff 标签,您可以显示`{+ additions +}`或`[- deletions -]` 。
|
|
|
|
... | ... | @@ -296,7 +296,7 @@ $example = array( |
|
|
|
|
|
### 数学公式[](#math "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#math) 。
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#math) 。
|
|
|
|
|
|
可以使用[KaTeX](https://github.com/KaTeX/KaTeX)渲染用 LaTeX 语法编写的数学运算。
|
|
|
|
... | ... | @@ -360,7 +360,7 @@ GFM 将识别以下内容: |
|
|
|
|
|
### 任务列表[](#task-lists "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#task-lists)。
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#task-lists)。
|
|
|
|
|
|
您可以在支持 Markdown 的任何位置添加任务列表,如果它们处于 Issue、合并请求或评论中,可以通过"单击"切换状态。但在其他地方,您必须手动编辑 Markdown 以通过在方括号内添加或删除`x`来更改状态。
|
|
|
|
... | ... | @@ -490,7 +490,7 @@ Quote break. |
|
|
|
|
|
#### 多个引用块[](#multiline-blockquote "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#multiline-blockquote) 。
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#multiline-blockquote) 。
|
|
|
|
|
|
GFM 还支持`>>>`围起来的多行块引用,从而扩展了标准的 Markdown 标准:
|
|
|
|
... | ... | @@ -553,7 +553,7 @@ Tildes are OK too. |
|
|
|
|
|
#### 代码块颜色及语法高亮[](#colored-code-and-syntax-highlighting "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#colored-code-and-syntax-highlighting) 。
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#colored-code-and-syntax-highlighting) 。
|
|
|
|
|
|
GitLab 使用[Rouge Ruby 库](http://rouge.jneen.net/)在代码块中突出显示了更加丰富多彩的语法. 有关支持的语言的列表,请访问[Rouge 项目 Wiki](https://github.com/rouge-ruby/rouge/wiki/List-of-supported-languages-and-lexers) . 语法突出显示仅在代码块中受支持,因此在内联时无法突出显示代码.
|
|
|
|
... | ... | @@ -624,7 +624,7 @@ Strikethrough uses two tildes. ~~Scratch this.~~ |
|
|
|
|
|
#### Multiple underscores in words and mid-word emphasis[](#multiple-underscores-in-words-and-mid-word-emphasis "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#multiple-underscores-in-words)。
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#multiple-underscores-in-words)。
|
|
|
|
|
|
仅将单词的*一部分*斜体化通常是没有用的,尤其是当您要处理经常带有多个下划线的代码和名称时。 结果,GFM 通过忽略单词中的多个下划线来扩展了标准的 Markdown 标准,以更好地呈现讨论代码的 Markdown 文档:
|
|
|
|
... | ... | @@ -741,7 +741,7 @@ Reference-style (hover to see title text): |
|
|
|
|
|
#### 视频[](#videos "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#videos) 。
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#videos) 。
|
|
|
|
|
|
链接到带有视频扩展名的文件的图像标签会自动转换为视频播放器. 有效的视频扩展名是`.mp4` , `.m4v` , `.mov` , `.webm`和`.ogv` :
|
|
|
|
... | ... | @@ -752,7 +752,7 @@ Here's a sample video: |
|
|
|
|
|
#### 音频[](#audio "Permalink")
|
|
|
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#audio) 。
|
|
|
> 如果未正确呈现,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#audio) 。
|
|
|
|
|
|
与视频类似,带有音频扩展名的文件的链接标签会自动转换为音频播放器,有效的音频扩展名是`.mp3` , `.oga` , `.ogg` , `.spx`和`.wav` :
|
|
|
|
... | ... | @@ -763,7 +763,7 @@ Here's a sample audio clip: |
|
|
|
|
|
### 行内 HTML[](#inline-html "Permalink")
|
|
|
|
|
|
> 要在第二个示例中[查看](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#inline-html)在 HTML 中呈现的 Markdown,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#inline-html) 。
|
|
|
> 要在第二个示例中[查看](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#inline-html)在 HTML 中呈现的 Markdown,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#inline-html) 。
|
|
|
|
|
|
您还可以在 Markdown 中使用原始 HTML,通常效果都很好。
|
|
|
|
... | ... | @@ -793,7 +793,7 @@ Here's a sample audio clip: |
|
|
|
|
|
#### Details and summary[](#details-and-summary "Permalink")
|
|
|
|
|
|
> 要在第二个示例中[查看](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#details-and-summary)在 HTML 中呈现的 Markdown,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#details-and-summary) 。
|
|
|
> 要在第二个示例中[查看](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#details-and-summary)在 HTML 中呈现的 Markdown,请[在 GitLab 本身中查看它](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#details-and-summary) 。
|
|
|
|
|
|
可以使用 HTML 的[`<details>`](https://s0developer0mozilla0org.icopy.site/en-US/docs/Web/HTML/Element/details)和[`<summary>`](https://s0developer0mozilla0org.icopy.site/en-US/docs/Web/HTML/Element/summary)标记折叠内容. 这对于折叠长日志特别有用,因为它们占用更少的屏幕空间。
|
|
|
|
... | ... | @@ -1010,7 +1010,7 @@ while the equation for the theory of relativity is E = mc<sup>2</sup>. |
|
|
|
|
|
(另外,你可以通过添加冒号选择文本列中的对齐`:`第二行中的"破折号"线条的两侧), 这将影响列中的每个单元格。
|
|
|
|
|
|
**注意:** [在 GitLab 本身中](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown#tables) ,标题始终在 Chrome 和 Firefox 中左对齐,并在 Safari 中居中。
|
|
|
**注意:** [在 GitLab 本身中](https://gitlab.com/gitlab-org/gitlab/blob/master/doc/user/markdown.md#tables) ,标题始终在 Chrome 和 Firefox 中左对齐,并在 Safari 中居中。
|
|
|
|
|
|
```
|
|
|
| Left Aligned | Centered | Right Aligned | Left Aligned | Centered | Right Aligned |
|
... | ... | |