From 3b8b99b24d7d16b6b2b1765c7649e9def80583a2 Mon Sep 17 00:00:00 2001
From: csh <caoshenghui@tinysoft.com.cn>
Date: Sat, 10 Jan 2026 21:51:14 +0800
Subject: [PATCH] :art: style(markdown): normalize md headings and lists

---
 README.md                                  |  4 ++--
 docs/tsl/syntax_book/01_language_basics.md | 10 +++++-----
 docs/tsl/syntax_book/03_functions.md       |  4 ++--
 rulesets/index.md                          |  8 ++++----
 4 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/README.md b/README.md
index 7100a8b..183bd21 100644
--- a/README.md
+++ b/README.md
@@ -178,7 +178,7 @@ git commit -m ":package: deps(playbook): add tsl standards"
    sh docs/standards/playbook/scripts/sync_standards.sh tsl cpp
    ```
 
-   >  说明：若项目根目录没有 `AGENTS.md`，`sync_standards.*`
+   > 说明：若项目根目录没有 `AGENTS.md`，`sync_standards.*`
    > 会自动生成最小版；已存在则不会覆盖。
 
 3. **验收**（任意满足其一即可）：
@@ -459,5 +459,5 @@ if (Test-Path $overlay) {
 - **同步策略**：每个规则集只同步到对应子目录（例如 `.agents/cpp/`），避免覆盖整个
   `.agents/`
 - **CI/工具**：按文件类型分别执行格式化、lint、测试（不要让 TSL 规则去约束 C++ 代码，反之亦然）
-  -  C++ 补全：建议在项目根目录提供 `.clangd` 并指向正确的
+  - C++ 补全：建议在项目根目录提供 `.clangd` 并指向正确的
     `CompilationDatabase`（模板见 `templates/cpp/.clangd`）
diff --git a/docs/tsl/syntax_book/01_language_basics.md b/docs/tsl/syntax_book/01_language_basics.md
index bdf5028..dcdeffa 100644
--- a/docs/tsl/syntax_book/01_language_basics.md
+++ b/docs/tsl/syntax_book/01_language_basics.md
@@ -1521,11 +1521,11 @@ TSL 语言还支持在字符串常量中表达'或者"的另外的方式，例
 也就是说，"This""s a book."代表 This"s a book.，但是"This''s a
 book."则代表的是 This''s a book.
 
-####号字符表达方式
+#### 号字符表达方式
 
 有时候，程序中需要表达特殊的难以直接输入的 ASCII 符，例如笑脸符的 ASCII 值为 1，要表达的时候就用#1 就可以表达了，而同样的，回车符的 ASCII 码值为 13，可以用#13 来表达，而字符 0 的 ASCII 码值为 48，则#48 可以表达数字字符 0。
 
-#号字符表达方式可以和引号的字符串表达方式串起来表达字符串常量，例如：'The first
+# 号字符表达方式可以和引号的字符串表达方式串起来表达字符串常量，例如：'The first
 line,Hello!'#13#10'The second line,Yeah!'#13#10'The End.'描述的字符串内容为：
 
 The first line,Hello!
@@ -1562,7 +1562,7 @@ s := L"\u5929\u8F6F";
 
 表示字符串 L"天软"
 
-#####在 Unicode 字符串连接中被自动识别为 Unicode 码，默认为 10 进制，因而需要使用 0x 代表 10 进制，如：
+##### 在 Unicode 字符串连接中被自动识别为 Unicode 码，默认为 10 进制，因而需要使用 0x 代表 10 进制，如：
 
 ```tsl
 s := L"AA"#0x5929#0x8F6F
@@ -1606,7 +1606,7 @@ TSL 语言默认的字符串均是 ANSI 类型的。
 
 字符串内转义\u 可以表达 unicode 字符，\u 后默认为 16 进制的 UNicode 码，如 L"\u5929\u8F6F"表达 L"天软"
 
-#在 Unicode 字符串连接中被自动识别为 Unciode 码，默认为 10 进制，因而需要用 0x 代表 16 进制，如 L""#0x5929#0x8F6F 表达 L"天软"
+# 在 Unicode 字符串连接中被自动识别为 Unciode 码，默认为 10 进制，因而需要用 0x 代表 16 进制，如 L""#0x5929#0x8F6F 表达 L"天软"
 
 TSL 许多字符串相关函数都支持 Unicode，函数版本一般是以 W 结尾,例如 InttoStrW(1)的结果是 L”1”。
 
@@ -1747,7 +1747,7 @@ return LJ = LJ2;
 
 数字字符 0。
 
-#号字符表达方式可以和引号的字符串表达方式串起来表达字符串常量。
+# 号字符表达方式可以和引号的字符串表达方式串起来表达字符串常量。
 
 例如：
 
diff --git a/docs/tsl/syntax_book/03_functions.md b/docs/tsl/syntax_book/03_functions.md
index 48700a4..c65d488 100644
--- a/docs/tsl/syntax_book/03_functions.md
+++ b/docs/tsl/syntax_book/03_functions.md
@@ -630,14 +630,14 @@ end);
 ```
 ### ##匿名函数以及函数指针的调用
 
-####A(1,2)代表 A 的类型是一个匿名函数或者函数指针类型，调用这个匿名函数或者函数指针代表的函数，送入 1，2 两个参数。
+#### A(1,2)代表 A 的类型是一个匿名函数或者函数指针类型，调用这个匿名函数或者函数指针代表的函数，送入 1，2 两个参数。
 
 A(1,2)则表示 A 是一个名字为 A 的函数。
 
 ```tsl
 B := FindFunction("A"); // FindFunction 可以查找函数并返回该函数的指针。
 ```
-##B(1,2)的运行过程等同于 A(1,2)
+## B(1,2)的运行过程等同于 A(1,2)
 
 ### ::指定调用全局函/单元函数
 
diff --git a/rulesets/index.md b/rulesets/index.md
index 81edaca..647752a 100644
--- a/rulesets/index.md
+++ b/rulesets/index.md
@@ -5,10 +5,10 @@
 > - **模板源**：`playbook/rulesets/` → 通过 `sync_standards.*` 同步 → 目标项目的 `.agents/`
 > - **AI 读取**：目标项目根目录的 `.agents/`，而非此处
 > - **使用流程**：
->   ```
->   playbook/rulesets/tsl/  →  [sync]  →  your-project/.agents/tsl/  ←  AI 代理读取
->      (模板源)                               (实际使用)
->   ```
+> ```
+> playbook/rulesets/tsl/  →  [sync]  →  your-project/.agents/tsl/  ←  AI 代理读取
+> (模板源)                               (实际使用)
+> ```
 
 本目录用于存放 **AI/自动化代理规则集模板**，用于分发到其他项目。