From 5704e6d4e38a558924dcccc1388d47f44aa543a4 Mon Sep 17 00:00:00 2001
From: PinkRabbit <693511570@qq.com>
Date: Sat, 27 Jan 2024 14:50:15 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=8F=90=E5=8F=8A=EF=BC=88at?=
 =?UTF-8?q?=EF=BC=89=E4=BB=96=E4=BA=BA=E7=9A=84=E5=86=85=E5=AE=B9=E5=92=8C?=
 =?UTF-8?q?=E5=85=B6=E4=BB=96=E4=BF=AE=E5=A4=8D=20(#53)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 添加换行、at 其他用户

见帖子 https://www.luogu.com.cn/discuss/765523 的需求

* 修复 typo，改进语言

* 更新 Bilibili 视频说明，旧的点不进去了
---
 docs/rules/academic/handbook/markdown.md | 77 ++++++++++++++++++++++--
 1 file changed, 72 insertions(+), 5 deletions(-)

diff --git a/docs/rules/academic/handbook/markdown.md b/docs/rules/academic/handbook/markdown.md
index 4a695eb..364617b 100644
--- a/docs/rules/academic/handbook/markdown.md
+++ b/docs/rules/academic/handbook/markdown.md
@@ -10,6 +10,73 @@ Markdown 的目标是实现「易读易写」，成为一种适用于网络的
 
 > 空行：一行之内只包含回车换行、空格、制表符。
 
+**例如：**
+
+```markdown
+这是第一段话
+
+这是第二段话
+```
+
+显示的效果如下：
+
+这是第一段话
+
+这是第二段话
+
+**如果两段之间不空一行，则无法正确分段。反面例子：**
+
+```markdown
+这是第一段话
+这是第二段话
+```
+
+显示的效果如下：
+
+这是第一段话 这是第二段话
+
+## 段落内部换行
+
+在行末输入**两个空格**可以达到比分段更加紧凑的换行的效果。
+
+**例如：**
+
+```markdown
+这是第一行  
+这是第二行
+```
+
+（请注意“这是第一行”后的两个空格，可以用鼠标拖动选中它们）
+
+显示的效果如下：
+
+这是第一行  
+这是第二行
+
+## 提及（at）他人
+
+要在洛谷讨论区回复中提及其他用户（即“at”该用户），可以使用符号 @ 后面紧跟该用户的用户名，再紧跟空格。
+
+**例如：**
+
+```markdown
+洛谷网的站长是 @kkksc03 ，网站于 2013 年开始运营。
+```
+
+（请注意“`@kkksc03`”后的空格，由于用户名中不会有空格，它起到分隔用户名和后面的内容的作用）
+
+显示的效果如下：
+
+洛谷网的站长是 @[kkksc03](https://www.luogu.com.cn/user/1) ，网站于 2013 年开始运营。
+
+:::caution
+
+本功能仅适用于洛谷**讨论区的回复**中，在其他使用 Markdown 的地方无效。
+
+只有使用此方式才能让被提及的用户收到**系统通知**，获知是在什么时间、哪篇帖子内的回复、被哪位用户提及了。
+
+:::
+
 ## 标题
 
 Markdown 的标题是在行首插入 1 到 6 个 `#`，`#` 和标题文字之间使用一个或多个空格，对应到标题 $1$ 到 $6$ 级。
@@ -66,7 +133,7 @@ __双下划线加粗__
 
 ~~删除线~~
 
-但是如果你的 `*` 和 `_` 两边都有空白的话，它们就只会被当成普通的符号。如果要在文字前后直接插入普通的星号或底线，你可以用反斜线（`\`）（参见下面的“反斜杠”部分）。
+但是如果 `*` 或 `_` 的两边都有空白的话，它们就只会被当成普通的符号。如果要在文字前后直接插入普通的星号或底线，可以用反斜线（`\`）（参见下面的“反斜杠”部分）。
 
 **例如：**
 
@@ -98,7 +165,7 @@ Markdown 建立代码块的方法：将 \`\`\` 置于这段代码的首行和末
 
 需要引用代码时，如果引用的语句只有一段，不分行，可以用 \` 将语句包起来。
 
-注：如果你真的要打 \` 这个字符的话，可以仿照和 \* 这个字符一样的处理方式，在 \` 前加一个反斜杠。
+注：如果真的要打 \` 这个字符的话，可以仿照和 \* 这个字符一样的处理方式，在 \` 前加一个反斜杠。
 
 ## 区块引用
 
@@ -194,7 +261,7 @@ Markdown 支持有序列表和无序列表，无序列表使用星号、加号
 
 ## 链接
 
-在方块括号后面紧接着圆括号并插入网址链接即可，如果你还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：
+在方块括号后面紧接着圆括号并插入网址链接即可，如果还想要加上链接的 title 文字，只要在网址后面，用双引号把 title 文字包起来即可，例如：
 
 ```md
 [行内式链接标题](http://www.luogu.org/)
@@ -266,7 +333,7 @@ Markdown 支持以比较简短的自动链接形式来处理网址和电子邮
 
 ## 反斜杠
 
-Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果你想要用星号加在文字旁边的方式来做出强调效果（但不用 `<em>` 标签），你可以在星号的前面加上反斜杠。
+Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号，例如：如果想要用星号加在文字旁边的方式来做出强调效果（但不用 `<em>` 标签），可以在星号的前面加上反斜杠。
 
 Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号（加上反斜杠后，这些符号都会以原来的方式显示）：
 
@@ -287,7 +354,7 @@ _   底线
 
 ## 插入 Bilibili 视频
 
-见 <https://www.luogu.com.cn/paste/l9faoe0v>。
+见 <https://www.luogu.com.cn/paste/okqcziz9>。
 
 ## LaTeX 公式支持