docs: 清除 markdown lint 警告(MD040 補語言標註、MD060 關閉)

- MD040:AGENTS.md 四處與 README.md 一處的 fenced code block 補上語言標註
  (目錄樹與格式範例用 text,index.md / log.md 的範例用 markdown)。

- MD060:本專案文件表格一律按終端顯示寬度對齊(CJK 佔 2 欄),而 MD060 以
  字元位置比對管線符號,對 CJK 無感,兩者不可能同時滿足。選擇保留顯示寬度
  對齊(人類在編輯器裡讀得順),以 .markdownlint.jsonc 關閉該規則並註明理由。
  順帶修正 AGENTS.md §3.1 表格 entity 列的對齊——該列混入 ASCII 的 API,
  原本比其他列短 1 欄。

未處理 MD013(行長 > 80):VS Code 的 markdownlint 擴充預設不啟用此規則,
且 §3.1 表格在維持顯示對齊的前提下無法壓到 80 字元以內。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
LittleYellow
2026-07-22 07:35:44 +08:00
parent 0b4c2bbb15
commit b2eb4fbfa3
3 changed files with 13 additions and 6 deletions

7
.markdownlint.jsonc Normal file
View File

@@ -0,0 +1,7 @@
{
// 本專案文件以繁體中文為主表格一律按「終端顯示寬度」對齊CJK 字元佔 2 欄),
// 這是人類在編輯器裡讀得順的排法。MD060 以「字元位置」比對管線符號,對 CJK
// 無感——兩者不可能同時滿足。選擇保留顯示寬度對齊,關閉此規則。
// 其餘規則維持預設(含 MD040程式碼區塊必須標語言
"MD060": false
}