辦公文檔 · 實用教程
Markdown有序列表爲什麼不按手寫數字顯示:起始編號、續接與重開怎麼檢查
源碼寫1、1、1卻顯示1、2、3,插入說明後編號又重置?用短示例檢查Markdown列表的起始數字、段落和代碼塊歸屬,以及獨立列表的重新編號。
先看結論
Markdown 有序列表通常由渲染器連續編號。按 CommonMark 規則,同一列表只用第一項的數字確定起點,後續源碼數字不決定各項顯示編號。因此,源碼連續寫三個 `1.`,顯示爲 1、2、3 是正常行爲;想重新從 1 開始,僅把中間某項改爲 `1.` 不夠,還需要讓它成爲一份新列表。[CommonMark 列表規則](https://spec.commonmark.org/0.31.2/#lists)明確說明了這一點。
打開相關入口開始前先確認
排錯時先確定目標:你要的是連續操作步驟、分段後的接續步驟,還是兩組各自編號的任務。三種目標對應不同結構。
先用三行確認編號起點
以下是假設的交接步驟,用來觀察符合 CommonMark 規則的渲染結果:
4. 检查文件名
1. 核对附件
9. 交付文档這是一份從 4 開始的列表,預期編號是 4、5、6,而不是源碼中的 4、1、9。不要通過修改第二、第三項的數字修復跳號;先看第一項,以及這三行是否被解析爲同一列表。
如果任務要求保留“問題 4、問題 9、問題 15”這樣的固定編號,建議把編號寫進表格字段或正文標籤,例如“問題 9:附件缺失”。固定編號承擔識別作用,連續列表承擔排序作用,選擇能準確表達用途的形式更便於後續增刪。
插入說明後繼續編號:先讓說明歸屬正確
假設第二步需要附加一段解釋,第三步仍屬於同一流程,可以這樣寫:
1. 收集文件
2. 核对附件
附件名称应与交接清单一致。
3. 交付文档這裏的說明段落前有三個空格,與 2. 後的正文起點對齊。它表達的是“第二項中的補充說明”。列表項內後續塊的縮進與列表標記和正文起點有關,不能把一個固定空格數套用到所有編號寬度;具體規則見 CommonMark 列表項說明。
操作時先檢查說明屬於哪一步,再調整縮進。如果還包含子步驟,可參考 Markdown 列表縮進排錯區分附屬內容與下一層列表,不必爲了修正顯示數字重排整篇文章。
如果插入的是代碼示例,同樣要檢查其歸屬。下面是另一段假設性源碼,代碼塊放在第二項內部:
1. 收集文件
2. 查看命名示例
```text
report_final.md
```
3. 交付文档當代碼之後的編號異常,優先檢查圍欄是否成對、縮進是否仍對應第二項。需要覈對代碼邊界時,可使用 Markdown 代碼塊寫法與排錯。改數字不能補救一個歸屬錯誤的代碼塊。
獨立段落之後續接,與新階段從 1 開始
若說明討論整個流程,應讓它成爲列表外的獨立段落,再顯式寫出後半段的起始編號:
1. 收集文件
2. 核对附件
以下操作由接收方完成。
3. 检查交付目录
4. 确认接收這樣表達的是兩份列表,後半段從 3 開始。它在視覺上接續,但編輯時需要自行維護這個起點:如果前半段新增一步,就應重新檢查後半段是否仍該從 3 開始。保留段落前後的空行,也能讓結構更容易複覈。
若兩組步驟應當分別從 1 開始,用真實的階段標題劃分,讀者也更容易理解:
## 准备阶段
1. 收集文件
2. 核对附件
## 接收阶段
1. 检查交付目录
2. 确认接收不要只在兩個 1. 之間多加空行來表達新階段。CommonMark 允許同一列表的項目之間存在空行;空行本身不保證重新編號。對應規範可用於覈對這一邊界。
按現象檢查,不反覆試改數字
| 看到的現象 | 優先檢查 | 建議處理 |
|---|---|---|
| 源碼全寫 1,顯示連續數字 | 是否正是連續步驟 | 符合目標就保留 |
| 中間寫 1,卻沒有重開 | 是否仍屬於同一列表 | 用階段標題明確劃分新列表 |
| 插入說明後意外從 1 開始 | 說明是否到了列表外 | 按說明用途決定縮進,或設置新列表起點 |
| 代碼之後編號錯亂 | 代碼圍欄和列表項歸屬 | 先修復結構,再覈對編號 |
| 跳躍編號被自動排連續 | 編號是否是固定業務標識 | 改用明確標籤或編號字段 |
| 預覽正確,成品不同 | 兩處是否使用相同實現和樣式 | 用同一段最小源碼比較最終輸出 |
交付前核對三件事
先保留原文件,單獨複製出“前兩項、插入內容、後一項”作爲檢查樣本。記錄預期起點、項目數量和最後一個編號,再在目標軟件中核對。這裏的預期來自文檔用途,不應僅以源碼裏手寫了什麼數字爲準。
接着檢查中間的說明和代碼究竟屬於某一步,還是獨立於整個列表。最後再看導出成品;需要交付 HTML 或 PDF 時,可按 Markdown 導出檢查流程覈對。只有最終閱讀位置的編號、層級和內容歸屬都符合預期,纔算完成這次文檔修正。
依據與進一步閱讀
試着完成自己的任務
先用一份小樣本驗證流程,再處理正式文件。指南免費閱讀,工具的體驗範圍與積分價格見產品詳情。
前往相關頁面