fix: 修复渲染 (#121)

* fix: correctly render formulas, emojis and strikethrough
fix: broken reference
docs: add emoji guide

* chore: remove unnecessary files

Author: Paulkm2006

docs/ch3/sec0/1-basic.md

@@ -8,15 +8,15 @@ Markdown 是一种轻量级标记语言，具有**语法简洁、易读易写**
 
 ## 1. 标题
 
-使用 `#` 表示标题，`#` 的数量决定标题级别（从 1 级到 6 级）。合理设置标题层级，有助于提升文档结构清晰度，方便他人快速查找所需。
+使用 `#` 表示标题，`#` 的数量决定标题级别（从 1 级到 5 级）。合理设置标题层级，有助于提升文档结构清晰度，方便他人快速查找所需。
 
 ```md preview
 # 一级标题
 ## 二级标题
 ### 三级标题
 #### 四级标题
 ##### 五级标题
-###### 六级标题
+内容
 ```
 
 ## 2. 段落与换行
@@ -42,6 +42,12 @@ Markdown 是一种轻量级标记语言，具有**语法简洁、易读易写**
 - **加粗**：`**加粗**` 或 `__加粗__`
 - *斜体*：`*斜体*` 或 `_斜体_`
 - ~~删除线~~：`~~删除线~~`
+
+或者以上方法的混用，如：
+
+- ***加粗斜体***
+- ~~*斜体删除*~~
+
 ```
 
 ## 4. 列表
@@ -53,6 +59,8 @@ Markdown 是一种轻量级标记语言，具有**语法简洁、易读易写**
 - 项目 1
 - 项目 2
 
+---
+
 1. 第一项
 2. 第二项
 ```
@@ -64,7 +72,7 @@ Markdown 是一种轻量级标记语言，具有**语法简洁、易读易写**
 - 可点击的图片：`[![描述](图片地址)](点击后打开的地址)`
 
 ```md preview
-[百度](https://www.baidu.com)
+[华科开放原子俱乐部](https://oss.hust.openatom.club)
 ![Logo](https://oss.hust.openatom.club/assets/logo.png)
 [![Logo](https://oss.hust.openatom.club/assets/logo.png)](https://hust.openatom.club)
 ```

docs/ch3/sec0/2-advanced.md

@@ -11,23 +11,18 @@ Markdown 除了基本的文本格式化，还支持更高级的功能，如公
 Markdown 支持使用 LaTeX 语法书写数学公式，常见于支持 MathJax 或 KaTeX 的渲染器中。
 
 **行内公式**：使用 `$...$` 包裹公式内容  
-例如：`$E=mc^2$` 显示为 $E=mc^2$
+```md preview
+$E=mc^2$
+```
 
 **块级公式**：使用 `$$...$$` 包裹公式内容  
-例如：
 
-```bash
+```md preview
 $$
 \int_{a}^{b} f(x)\,dx = F(b) - F(a)
 $$
 ```
 
-显示为：
-
-<p align="center">
-    <img src="https://latex2png.com/pngs/c838ec0ff6cf48f333a310ba72dba65c.png" alt="LaTeX 公式图片" width="200">
-</p>
-
 ## 2. HTML 标签与 CSS 样式
 
 Markdown 支持直接嵌入原生 HTML 标签，以实现更复杂的排版和样式。例如：
@@ -119,7 +114,7 @@ Mermaid 提供了[在线的图标编辑器](https://www.mermaidchart.com/play)
 
 ### 勾选框
 
-```markdown
+```md preview
 - [ ] 未勾选的项目
 - [x] 勾选的项目
 ```
@@ -128,6 +123,14 @@ Mermaid 提供了[在线的图标编辑器](https://www.mermaidchart.com/play)
 
 可以通过 `:CODE:` 来插入一个表情。其中，每个表情的`code`可通过[这个网页](https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md)查询
 
+通常来说，我们会在[commit message](../sec1/subsec2/6-commit-message.md)的初始位置插入一个表情符号，让用户和其他维护者能够一眼看出此次 commit 的性质，如：
+
+```md preview
+:hammer: fix(api): fix handling logic
+
+:broom: chore: cleanup build deps
+```
+
 ### 提及其他人（Github）
 
 可以使用 `@username` 或 `@org/team` 提及 Github 的用户。被提及的用户会收到通知。

docs/ch3/sec2/4-other-commands.md

@@ -63,7 +63,7 @@ man 可以被称为 Linux 系统的百科全书。从命令使用到操作系统
       一般来说，我们无需指定章节号。但是对于某些可能存在于多个章节的条目（比如`printf`既是一个位于章节 1 的工具，也是一个位于章节 3 的 API 函数），要想跳到其他章节，这个编号就是必须的。此时，命令的结构为 `man [section] name`
 
 !!! info
-    对于绝大部分人类来说，man pages 的文档还是有些过于晦涩了。别担心！我们可以使用一个叫`tldr`的开源工具来阅读更加实用、通俗易懂的说明。关于这个工具的详情，请参考下一节的“[常用的开源工具](../sec3/1-useful-oss.md)”篇目。
+    对于绝大部分人类来说，man pages 的文档还是有些过于晦涩了。别担心！我们可以使用一个叫`tldr`的开源工具来阅读更加实用、通俗易懂的说明。关于这个工具的详情，请参考下一节的“[常用的开源工具](../sec5/1-useful-oss.md)”篇目。
 
 ### 1. 任务管理器系列
 
@@ -601,7 +601,7 @@ Windows 里，我们可以使用设备管理器（devmgmt.msc）、磁盘管理
     若想从终端中分离，可以同时按下`Ctrl+A+D`按键
     若想结束一个终端，可以执行`screen -XS <session-id> quit`
     !!! note
-        screen 工具由于维护不佳，导致出现了[许多漏洞](https://security.opensuse.org/2025/05/12/screen-security-issues.html)。在可能的情况下，我们更加推荐使用 tmux。关于这个工具的详情，请参考下一节的“[常用的开源工具](../sec3/1-useful-oss.md)”篇目
+        screen 工具由于维护不佳，导致出现了[许多漏洞](https://security.opensuse.org/2025/05/12/screen-security-issues.html)。在可能的情况下，我们更加推荐使用 tmux。关于这个工具的详情，请参考下一节的“[常用的开源工具](../sec5/1-useful-oss.md)”篇目
 
 ## 🧪 小练习
 

docs/scripts/mathjax.js

@@ -0,0 +1,19 @@
+window.MathJax = {
+	tex: {
+		inlineMath: [["\\(", "\\)"]],
+		displayMath: [["\\[", "\\]"]],
+		processEscapes: true,
+		processEnvironments: true
+	},
+	options: {
+		ignoreHtmlClass: ".*|",
+		processHtmlClass: "arithmatex"
+	}
+};
+
+document$.subscribe(() => {
+	MathJax.startup.output.clearCache()
+	MathJax.typesetClear()
+	MathJax.texReset()
+	MathJax.typesetPromise()
+})

mkdocs.yml

@@ -52,10 +52,14 @@ markdown_extensions:
   - footnotes
   - markdown.extensions.def_list
   - md_in_html
+  - pymdownx.arithmatex:
+      generic: true
+  - pymdownx.tilde
   - pymdownx.details
   - pymdownx.tabbed
   - pymdownx.extra
   - pymdownx.inlinehilite
+  - attr_list
   - pymdownx.emoji:
       emoji_index: !!python/name:material.extensions.emoji.twemoji
       emoji_generator: !!python/name:material.extensions.emoji.to_svg
@@ -73,6 +77,8 @@ markdown_extensions:
           format: !!python/name:pymdownx.superfences.fence_code_format
   - toc:
       permalink: true
+  - pymdownx.tasklist:
+      custom_checkbox: true
 
 extra:
   social:
@@ -141,3 +147,7 @@ nav:
     - 第四章 导览: ch4/index.md
   - 附录:
     - 关于本教程: ch99/abouts.md
+
+extra_javascript:
+  - scripts/mathjax.js
+  - https://unpkg.com/mathjax@3/es5/tex-mml-chtml.js