🔧 chore(markdown): add markdownlint baseline and lint fixes

This commit is contained in:
csh
2026-05-18 15:43:48 +08:00
parent a22b324c5c
commit 214c44eebc
10 changed files with 22 additions and 9 deletions
+2 -2
View File
@@ -3,8 +3,8 @@
本 Playbook 的 Python 代码风格以 Google Python Style Guide 为基线(基于 PEP
8):
- Google Python Style Guide: https://google.github.io/styleguide/pyguide.html
- PEP 8: https://peps.python.org/pep-0008/
- Google Python Style Guide: <https://google.github.io/styleguide/pyguide.html>
- PEP 8: <https://peps.python.org/pep-0008/>
## 项目约定(Project Conventions
+1 -1
View File
@@ -40,7 +40,7 @@ Guide 对齐:通过名字的“形状”快速判断实体类型(类型/函
- 自定义标识符只使用本指南约定的 `PascalCase`/`snake_case``lowerCamelCase`
仅用于沿用内置/标准库/第三方 API 的既有命名。
**大小写与关键字约定**
### 大小写与关键字约定
- TSL 语言大小写无关,但本指南仍要求按约定使用大小写以提升可读性;不要用仅大小写不同的名字区分不同实体;同一标识符在仓库中应保持一致写法。
- 所有语法关键字统一使用全小写书写,例如
+3 -1
View File
@@ -555,7 +555,9 @@ WriteLn(s[1:3]);
s := %%ABC%%;
```
上面这种写法在当前解释器里会报 `missing or invalid characters``%%` 原始字符串开头后面必须先跟一个空白分隔符,或者写成 `%%tag ` 这种“标识符 + 空白”形式。
上面这种写法在当前解释器里会报 `missing or invalid characters``%%`
原始字符串开头后面必须先跟一个空白分隔符,或者写成 `%%tag<space>`
这种“标识符 + 空白”形式。
代码块身份:反例 / 不可照写
+2 -2
View File
@@ -2,8 +2,8 @@
本 Playbook 的 TypeScript/JavaScript 代码风格以 Google TypeScript Style Guide 为基线:
- Google TypeScript Style Guide: https://google.github.io/styleguide/tsguide.html
- TypeScript 官方手册: https://www.typescriptlang.org/docs/handbook/
- Google TypeScript Style Guide: <https://google.github.io/styleguide/tsguide.html>
- TypeScript 官方手册: <https://www.typescriptlang.org/docs/handbook/>
## 项目约定