[说明文档] Markdown和shortcode

Markdown是一种用于很多博客、评论区的标记语言,最常见的用处是github中的README.md。

本站的评论也支持Markdown,以Parsedown为标准

图标含义:

属于Markdown标准

在代码块中仍然起作用(因此危险),并且不能用\字符屏蔽。

本站主题(Kratos)的特有功能(多以短码形式体现)

无法使用“只使用HTML”功能屏蔽

对Markdown常见理解错误

有的人一看到支持Markdown就打[url=https://www.baidu.com/]百度一下[/url]这种代码(尤其垃圾评论里面一堆这种的)。

说明:这不是Markdown。Markdown超链接格式是[链接文字](https://example.com/ "悬停提示")

分段与换行

第一段

第二段.1
第二段.2

在Markdown中,空一行代表分段。在标准Markdown中,如果需要在一段中换行,除了Enter之外,还要在前一行行尾加上两个空格。本站直接Enter即可。

段落的内容不可使用Tab或空格缩进。

第一段

第二段.1  
第二段.2

标题

一级标题

一级标题2

二级标题

二级标题2

三级标题

四级标题

五级标题
六级标题

在Markdown中,在行之前加#表示标题,标题级别等于#的数量。在#之后,需要加一个空格。

对于二级标题,可以在一行文字后加上---

不建议使用一级标题。

# 一级标题

一级标题2
===

## 二级标题

二级标题2
---

### 三级标题

#### 四级标题

##### 五级标题

###### 六级标题

粗体、斜体和删除线

粗体
斜体
粗斜体
混合语法akioi
删除线
混合语法akioi

Markdown中,文本两边加上**__为粗体,*_为斜体。另外,在非标准Markdown中,使用~~可以实现删除线。

**粗体**  
*斜体*  
***粗斜体***  
*混合**语法**akioi*  
~~删除线~~  
~~*混合**语法**akioi*~~

如果需要需要单独使用* _ ~ 等字符,则需要在这些字符前面添加\

*这不是斜体*

**这不是加粗**

\~\~这不是删除线\~\~

*这不是斜体\*

\*\*这不是加粗\*\*

\~\~这不是删除线\~\~

分割线



在Markdown中,****---都表示分割线。可以在-*之间插入换行。可以使用更多的*-

****

---

如果需要单独使用---****,需要在每个字符前加上\。同样,-*混用也不是删除线。

---

****

-*-

-\-\-

\*\*\*\*

-*-

列表与列表嵌套

  • 无序表
  1. 有序表
  • 嵌套无序表
    • 嵌套项1
    • 嵌套项2
  1. 嵌套有序表
    1. 嵌套项1
    2. 嵌套项2

Markdown中,可以用- + * 作为无序表符号,符号后要有空格。同一个无序表中使用的符号要统一。

在数字编号后加一个句点,然后空格,会自动生成有序表。嵌套的有序表会自动设定能够体现嵌套的序号。

有序表的数字编号如果是错的,会被自动更正。

以上两者均可以用缩进法实现嵌套(缩进为2个空格)。有序表嵌套和无序表相同。

- 无序表
- 二
- 三

1. 有序表
2. 二
3. 三

- 嵌套无序表
- 二
  - 嵌套项1
  - 嵌套项2
- 三

1. 嵌套有序表
4. 二
  1. 嵌套项1
  2. 嵌套项2
3. 三

如果不希望内容被识别为有序或无需列表,可以妥善使用\符号。

- 这不是列表
- 这也不是列表
- 这还是不是列表

1. 这不是列表
2. 这也不是列表
3. 这还是不是列表

- 这不是列表
\- 这也不是列表
\- 这还是不是列表

1\. 这不是列表
2\. 这也不是列表
3\. 这还是不是列表

引用

引用文本1.1
引用文本1.2

引用文本2.1

引用

引用的引用或引用中的引用。
Markdown基础语法仍然可以用于引用内容。

但是其样式可能会有不同。

> 引用文本1.1
> 引用文本1.2

> 引用文本2.1

> 引用
> > 引用的引用或引用中的引用。
> **Markdown**基础语法**仍然可以**用于引用内容。
> ### 但是其样式可能会有不同。

链接与图片

百度一下

替代文本

链接语法为[链接文字](https://example.com/ "悬停提示")

图片语法类似![替代文本](https://vjudge.net/static/images/beiju.jpg "悬停提示")(图片无法加载时会以“替代文本”来取代图片)

注意网址一定要加上https://等协议标志。如果不加上,将会引用相对资源,即如果文章页面是https://toxic2018.ml/1282/,你给出的网址是www.baidu.com/favicon.ico,那么引用的图片将是https://toxic2018.ml/1282/www.baidu.com/favicon.ico,当然无法加载。

本站由于某些原因不允许以http://形式给出的图片。如果图片是http://的,那么请换成https://,或者将这张图片上传到图床引用。

过多的超链接可能导致你的评论被判为垃圾。我们也将会严厉打击故意引用无效资源拖慢页面加载的行为。

[百度一下](https://www.baidu.com/?from=toxic2018.ml "百度一下")

![替代文本](https://vjudge.net/static/images/beiju.jpg "vjudge的卧槽")

注意:如果不使用超链接的语法,而直接粘贴链接地址,这个网址将不会成为可点击链接。

http://vjudge.net/problem/description

https://vjudge.net/problem/description

插入简单HTML

这是一个图标:

有时候Markdown并无法满足你的编辑要求。此时允许直接插入简单的HTML代码。试图遮盖页面的评论会被阻止。含有行为的HTML代码会被过滤掉。

Deprecated:由于某些原因,目前已经禁止插入HTML。所有HTML标签会被直接删除而不起作用。(见 PHP strip_tags 函数)

这是一个图标:<span class="fa fa-home"></span>

只使用HTML

如果你是专业人士,你可能只希望用HTML构建你的评论,而不经过Markdown。实现方法很简单,在评论任意位置加入<!--PARSEDOWN_DO_NOT_PARSE-->即可。

示例见评论区。

插入代码

这是一段行内代码:print("Hello, world!")

这是一长串代码:

//请勿尝试运行。若运行后果自负
#include<bits/stdc++.h>
#include<windows.h>
#include<winable.h>
using namespace std;

int main(){
    cout<<"你自由了!"<<endl;
    FreeConsole();
    while(1){
        BlockInput(1);
    }
}

在行内贴代码时,在代码两端加上"`"符号。

长串代码切忌直接粘贴,应当在前后各加三个"`"。如果需要代码高亮,请在代码前的符号后面直接跟上语言。如"cpp"。

这是一段行内代码:`print("Hello, world!")`

这是一长串代码:
```cpp
//请勿尝试运行。若运行后果自负
#include<bits/stdc++.h>
#include<windows.h>
#include<winable.h>
using namespace std;

int main(){
    cout<<"你自由了!"<<endl;
    FreeConsole();
    while(1){
        BlockInput(1);
    }
}

```

表格

姓名 语文 数学 总分
A 82 100 182
B 10 3 13
C 99 95 194

Markdown中,表格不需要对齐

| 姓名    | 语文 | 数学 | 总分 |
| ------- | ---- | ---- | ---- |
| A       | 82   | 100  | 182  |
| B       | 10   | 3    | 13   |
| C       | 99   | 95   | 194  |

LaTeX / 数学公式

将LaTeX代码包含在两个$字符中,可创建行内公式。

将LaTeX代码包含在左右各两个$中,并且独立成行,会生成多行公式并居中。

这是一个公式:a^2 + b^2 = c^2

这是一个多行居中公式:

I\ AK\ IOI

这是一个公式:$a^2 + b^2 = c^2$

这是一个多行居中公式:

$$I\ AK\ IOI$$

利用LaTeX,甚至可以做出超出公式范围的、有趣而有害的排版。

要使用LaTeX,必须在评论开头加上<!--Written with editor.md-->

文字与背景颜色

有颜色的文字

标记文本

淫秽的东西

文本颜色:使用 [col or=red]文本[/col] 即可
背景颜色:使用 [bcol or=red]文本[/bcol] 即可
请注意:只能使用red blue green基本单词作为颜色,不支持颜色代码

这是在代码块中仍然会被处理的代码。“文字颜色”功能属于本站特有,不属于Markdown标准。此后的功能都是本站特有。同样的,此后功能在代码块中也会被处理(因此在代码块中使用这些内容时要注意)。

[col or=red]有颜色[/col][col or=blue]的文字[/col]

[bcol or=yellow]标记文本[/bcol]

[bcol or=black][col or=black]淫秽的东西[/col][/bcol]

屏蔽器[blank]

下面是一些危险的代码:

<!--PARSEDOWN_DO_NOT_PARSE--> ——不能直接打出,否则Markdown会失效(见“只使用HTML”章节)

[col or=red]示例文字[/col] ——不能直接打出,否则会被理解成是文字颜色(见“文字颜色”章节)

### 标题行 ——不能直接打出,否则会变成标题。

[blank] ——不能直接打出,否则会被清除。

实际上,这些代码的打法大同小异。在本站,如果使用Markdown,那么系统会自动清除文档中的[blank]。因此,在想打出“有活性”(即,会被Markdown和本站系统处理的代码)时,可以在这个代码中插入一个[blank],使其失去活性。而输入的[blank]则会自动清除,不会影响视觉效果。实际上,本站上利用中括号处理的代码都是不能直接放进代码块的,此时也要用[blank]分隔。

下面是一些危险的代码:

`<!--PARSEDOWN[blank]_DO_NOT_PARSE-->`  ——不能直接打出,否则Markdown会失效(见“只使用HTML”章节)

[col [blank]or=red]示例文字[/c[blank]ol]  ——不能直接打出,否则会被理解成是文字颜色(见“文字颜色”章节)

[blank]### 标题行  ——不能直接打出,否则会变成标题。

[bla[blank]nk]  ——不能直接打出,否则会被清除。

内容标题

上面那个写着“内容标题”的标题就是内容标题。不提倡在评论中使用该标题。如果滥用这种标题刷屏将受处罚。

各级内容标题在逻辑上有区别,但是外观相同。

本功能和之后的功能都是“shortcode”,即,即使开启了“只使用HTML”,这些功能仍然有效。

# [title]一级内容标题[/title]
## [title]二级内容标题[/title]
...

可展开面板

这是标题
Text1
Text2

Text2.2

可展开面板的开始标志是[collapse title="标题"],结束标志是[/collapse]

[collapse title="这是标题"]
Text1
Text2

Text2.2
[/collapse]

要求评论文章

抱歉,只有登录并在本文发表评论才能阅读隐藏内容

该功能并非做样子,是确实可以起作用。不提倡使用。

注:如果在评论中使用此标签,访客只需回复文章,而不需要回复评论。看到隐藏内容的要求是:登录并回复。

[hide reply_to_this="true"]回复才能看到的文字[/hide]

下载按钮

本地下载 云盘下载

注:上面的按钮分别指向百度、必应。

本地下载:将下载地址放在[bdbtn][/bdbtn]之间。

云盘下载:和本地下载做法相同。将bdbtn改为ypbtn即可。

[bdbtn]https://www.baidu.com/[/bdbtn]  [ypbtn]https://cn.bing.com/[/ypbtn]

背景栏

绿色
蓝色
黄色
红色

将文本放在中括号标签间即可。

绿色:success,蓝色:info,黄色:warning,红色:danger

[success]绿色[/success]

[info]蓝色[/info]

[warning]黄色[/warning]

[danger]红色[/danger]

彩色内容框

标题内容

绿色

标题内容

蓝色

标题内容

黄色

标题内容

红色

和背景栏方法非常相似。不赘述。

[successbox title="标题内容"]绿色[/successbox]

[infobox title="标题内容"]蓝色[/infobox]

[warningbox title="标题内容"]黄色[/warningbox]

[dangerbox title="标题内容"]红色[/dangerbox]

注意:不可跨区块使用

不可跨区块使用的是成对的中括号标签。这些标签与HTML性质一样,因此需要满足HTML的规则(名曰:不可跨区块使用)

一个合法的HTML(包含中括号标签的),定义如下:

  • 任何不含[ ] < >的内容都是合法的。
  • 若文本A是合法的,那么对于任意不含[ ] < >的文本B,[B]A[/B][B ...]A[/B]都是合法的。
  • 若文本A是合法的,那么对于任意不含[ ] < >的文本B,<B>A</B><B ...>A</B>都是合法的。
  • 若文本A,B都是合法的,那么AB也是合法的。

另外,中括号标签是不可以跨段使用的。因为在HTML中,段落被放在<p> </p>中间。

根据上述定义,举下面的例子:

反面教材

**123[col or=red]45**678[/col]

---

123[col or=red]45

67[/col]89ABCDEF

正确做法

**123**[col or=red]**45**678[/col]

**123[col or=red]45[/col]**[col or=red]678[/col]

---

123[col or=red]45[/col]

[col or=red]67[/col]89ABCDEF

点赞
  1. 叶ID说道:
    Google Chrome Windows 10


    这是**没有**使用*Markdown*进行~~处理~~的文本

    代码:

    <!--PARSEDOWN_DO_NOT_PARSE-->
    这是**没有**使用*Markdown*进行~~处理~~的文本

发表评论

电子邮件地址不会被公开。必填项已用 * 标注