Skip to content

Commit 1a62b13

Browse files
committed
新前端 md 语法
1 parent d237ecb commit 1a62b13

File tree

8 files changed

+162
-7
lines changed

8 files changed

+162
-7
lines changed
58.6 KB
Loading
64 KB
Loading
64.1 KB
Loading
68.2 KB
Loading
24.2 KB
Loading
64.8 KB
Loading
76.5 KB
Loading

docs/rules/academic/handbook/markdown.md

Lines changed: 162 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,13 @@ Markdown 的目标是实现「易读易写」,成为一种适用于网络的
44

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

7+
:::info[请注意]
8+
9+
- 本页面显示效果非洛谷主站实际效果,仅作为参考。部分语法使用截图展示。
10+
- 部分新语法特性仅支持新前端页面,无法在老前端页面内使用。
11+
12+
:::
13+
714
## 段落和换行
815

916
一个 Markdown 段落是由一个或多个连续的文本行组成,它的前后要有一个以上的**空行**。普通的 Markdown 段落不可以用空格或制表符来缩进。
@@ -137,11 +144,33 @@ Markdown 建立代码块的方法:将 \`\`\` 置于这段代码的首行和末
137144
#include<iostream>
138145
```
139146

147+
### 指定范围高亮
148+
149+
【仅支持新前端页面】在代码块中首行使用 `lines=start-end` 来指定范围高亮。例如:
150+
151+
```markdown
152+
```cpp lines=5-6
153+
```
154+
155+
![代码高亮示例](./_image/code_block_Highlighting.png "5~6 行高亮")
156+
157+
这样代码块的第 5~6 行会被高亮。
158+
140159
### 小段代码
141160

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

144-
注:如果真的要打 \` 这个字符的话,可以仿照和 \* 这个字符一样的处理方式,在 \` 前加一个反斜杠。
163+
**例如:**
164+
165+
```markdown
166+
前面的内容 `printf("Hello World!\n");` 后面的内容。
167+
```
168+
169+
**显示的效果如下:**
170+
171+
前面的内容 `printf("Hello World!\n");` 后面的内容。
172+
173+
注:如果真的要打 \` 这个字符的话,可以仿照和 \* 这个字符一样的处理方式,在 \` 前加一个反斜杠`\`
145174

146175
## 区块引用
147176

@@ -168,7 +197,7 @@ Markdown 标记区块引用的方法是在行的最前面加 `>`,也可以只
168197
> > ```
169198
```
170199

171-
显示的效果如下:
200+
**显示的效果如下:**
172201

173202
> Markdown 标记区块引用的方法是在行的最前面加 `>`
174203
>
@@ -240,10 +269,12 @@ Markdown 支持有序列表和无序列表,无序列表使用星号、加号
240269
在方块括号后面紧接着圆括号并插入网址链接即可,如果还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:
241270

242271
```md
243-
[行内式链接标题](http://www.luogu.org/)
272+
[行内式链接标题](http://www.luogu.com.cn/ "可选标题")
244273
```
245274

246-
显示效果:这是 [行内式链接标题](http://www.luogu.org/ "可选标题") 内联方式。
275+
显示效果:
276+
277+
这是 [行内式链接标题](http://www.luogu.com.cn/ "可选标题") 内联方式。请将光标移至连接上查看效果。
247278

248279
## 图片
249280

@@ -260,19 +291,19 @@ Markdown 使用一种和链接很相似的语法来标记图片。在互联网
260291
**例如:**
261292

262293
```markdown
263-
![logo](https://cdn.class.luogu.com.cn/fe/logo-full.png?27925f707b34b1472e135b1a2dd848e5)
294+
![洛谷网校 logo](https://cdn.class.luogu.com.cn/fe/logo-full.png?27925f707b34b1472e135b1a2dd848e5 "洛谷网校 logo")
264295
```
265296

266297
将会显示图片:
267298

268-
![logo](https://cdn.class.luogu.com.cn/fe/logo-full.png?27925f707b34b1472e135b1a2dd848e5)
299+
![洛谷网校 logo](https://cdn.class.luogu.com.cn/fe/logo-full.png?27925f707b34b1472e135b1a2dd848e5 "洛谷网校 logo")
269300

270301
## 自动链接
271302

272303
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用尖括号包起来,Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:
273304

274305
```markdown
275-
[https://www.luogu.com.cn/](https://www.luogu.com.cn/)
306+
<https://www.luogu.com.cn/>
276307
```
277308

278309
显示效果为:
@@ -327,6 +358,130 @@ _ 底线
327358
. 英文句点
328359
! 惊叹号
329360
```
361+
## 表格合并
362+
363+
【仅支持新前端页面】在正常 Markdown 语法的基础上,结合`^`来跨行合并单元格,结合`<`来跨列合并单元格。在同一个表格内可混合使用这两种方式。
364+
365+
```markdown
366+
| 标题 1| 标题 2| 标题 3 |标题 4|
367+
|:-:|:--------:|:--------:|:--:|
368+
|1 |$\le 10$ |$\le 10$ |无 |
369+
|2 |^ |^ |无 |
370+
|3 |^ |^ |无 |
371+
|4 |$\le 3\times 10^5$|^ |无 |
372+
|5 |^ |^ |无 |
373+
|6 |^ |$\le 3\times 10^5$|无 |
374+
|7 |^ |^ |无 |
375+
|8 |^ |^ |无 |
376+
|9 |^ | 跨列合并 1 |< |
377+
|10 |跨列合并 2 |< |无 |
378+
```
379+
**效果:**
380+
381+
![表格合并示例](./_image/table_span.png)
382+
383+
## 更像 Tuack 的表格
384+
385+
【仅支持新前端页面】使用```:::cute-table{tuack}```来创建更像 Tuack 的表格。可以结合上文的表格合并语法使用。
386+
387+
```markdown
388+
::cute-table{tuack}
389+
390+
| 测试点编号 | $n, m \leq$ | $k \leq$ | 特殊性质 |
391+
| :-: | :-: | :-: | :-: |
392+
| $1, 2$ | $6$ | $6$ | C |
393+
| $3 \sim 5$ | $10^3$ | $10^3$ | ^ |
394+
| $6 \sim 8$ | $5 \times 10^4$ | $10^2$ | 无 |
395+
| $9, 10$ | $10^5$ | $10^5$ | AB |
396+
| $11, 12$ | ^ | ^ | A |
397+
| $13 \sim 15$ | ^ | ^ | C |
398+
| $16 \sim 18$ | ^ | ^ | 无 |
399+
| $19, 20$ | $3 \times 10^5$ | $2.5 \times 10^5$ | ^ |
400+
```
401+
**显示效果:**
402+
403+
![更像 Tuack 的表格示例](./_image/table_tuack.png)
404+
## 居中排版
405+
406+
【仅支持新前端页面】使用```:::align{center}```来居中排版。被此语法包裹的内容将居中显示(部分元素不支持)。
407+
408+
**例如:**
409+
410+
```markdown
411+
:::align{center}
412+
413+
![](https://cdn.luogu.com.cn/upload/usericon/1.png)
414+
123
415+
#### 标题 4
416+
:::
417+
```
418+
**显示效果:**
419+
420+
![居中排版示例](./_image/align_center.png)
421+
422+
## 居右排版
423+
424+
【仅支持新前端页面】使用```:::align{right}```来居右排版。被此语法包裹的内容将居右显示。
425+
426+
**例如:**
427+
428+
```markdown
429+
:::align{right}
430+
431+
![](https://cdn.luogu.com.cn/upload/usericon/1.png)
432+
123
433+
#### 标题 4
434+
:::
435+
```
436+
**显示效果:**
437+
438+
![居右排版示例](./_image/align_right.png)
439+
440+
## CF 风格 epigraph
441+
442+
【仅支持新前端页面】使用```:::epigraph```来创建 CF 风格 epigraph。
443+
444+
**例如:**
445+
446+
```markdown
447+
:::epigraph[——otto]
448+
大家好啊,我是说的道理,今天来点大家想看的东西。
449+
:::
450+
```
451+
452+
**显示效果:**
453+
454+
![CF 风格 epigraph 示例](./_image/epigraph.png)
455+
456+
## 折叠框
457+
458+
【仅支持新前端页面】使用```:::info``````:::success``````:::warning```来创建折叠框。并使用`{open}`来使折叠框默认展开。折叠框的标题支持 LaTeX 公式。
459+
460+
:::tip
461+
建议复制以下代码至洛谷文章编辑页内测试体验。
462+
:::
463+
464+
**例如:**
465+
466+
```markdown
467+
::::info[我是标题]
468+
大家好啊,我是说的道理,今天来点大家想看的东西。
469+
::::
470+
471+
::::info[我是默认展开的折叠框]{open}
472+
使用 `{open}` 使折叠框默认展开。
473+
::::
474+
475+
::::success[$$\displaystyle\sum_{i = 1}^n \sum_{j = 1}^n \gcd(i, j)$$]
476+
数学公式也是可以出现在标题上的。
477+
::::
478+
479+
::::warning[警告]
480+
这是一个警告框。
481+
::::
482+
```
483+
484+
![折叠框示例](./_image/Collapsible_Panel.png)
330485

331486
## 插入 Bilibili 视频
332487

0 commit comments

Comments
 (0)