markdown手册

奈

2023-11-21 16:15:14

发布于：江苏

140阅读

0回复

0点赞

Markdown 的目标是实现「易读易写」，成为一种适用于网络的书写语言。因此acgo普遍使用 Markdown 发布内容。

请仔细阅读下列文档，如果没有按照要求正确使用格式，将可能无法发出讨论，或者被删除。

段落和换行
一个 Markdown 段落是由一个或多个连续的文本行组成，它的前后要有一个以上的空行。普通的 Markdown 段落不可以用空格或制表符来缩进。

空行：一行之内只包含回车换行、空格、制表符。

标题
Markdown 的标题是在行首插入 1 到 6 个 #，# 和标题文字之间使用一个或多个空格，对应到标题
1
1 到
6
6 级。

例如：

这是 H1

这是 H2

这是 H3

这是正文

显示的效果如下：

标题与正文

警告
不要全文使用标题，或者用标题强调特别多的文字。这会让读者觉得困扰。

强调
Markdown 使用星号（*）和底线（_）作为标记强调字词的符号，被 * 或 _ 包围的字词会被转成用 <em> 标签包围（即斜体），用两个 * 或 _ 包起来的话，则会被转成 <strong>（即粗体）。

例如：

单星号斜体

单下划线斜体

双星号加粗

双下划线加粗

~~删除线~~

显示的效果如下：

单星号斜体

单下划线斜体

双星号加粗

双下划线加粗

删除线

但是如果你的 * 和 _ 两边都有空白的话，它们就只会被当成普通的符号。如果要在文字前后直接插入普通的星号或底线，你可以用反斜线（\）（参见下面的“反斜杠”部分）。

例如：

*使用反斜线开头的*被当做是普通的字符*

显示的效果如下：

使用反斜线开头的被当做是普通的字符*

代码块
如果要发送代码，但没有按照下面的方式进行格式化，将不能发送成功。

大段代码
Markdown 建立代码块的方法：将 置于这段代码的首行和末行，独立成一行。第一行的 后面可以加上语言名称，例如 cpp、java、c、pascal 等（不要写成 c++）。

例如：

C++代码示例

#include<iostream>

小段代码
需要引用代码时，如果引用的语句只有一段，不分行，可以用 ` 将语句包起来。

注：如果你真的要打 这个字符的话，可以仿照和 * 这个字符一样的处理方式，在 前加一个反斜杠。

区块引用
Markdown 标记区块引用的方法是在行的最前面加 >，也可以只在整个段落的第一行最前面加上 >，区块引用内部可以嵌套，只要根据层次加上不同数量的 > 即可，引用的区块内也可以使用其他的 Markdown 语法，包括标题、列表、代码区块等。

例如：

Markdown 标记区块引用的方法是在行的最前面加 >。

也可以只在整个段落的第一行最前面加上 >。
区块引用内部可以嵌套，只要根据层次加上不同数量的 > 即可。

我是内部嵌套区块，我可以使用其他 Markdown 语法哦。

我是引用区块内使用 3 级标题语法。
    //在引用区块内可以加入代码块
    import java.net.URL;
    import java.util.Arrays;
    import java.util.Date;
    import java.util.Set;