辦公文檔 · 實用教程

Markdown有序列表爲什麼不按手寫數字顯示:起始編號、續接與重開怎麼檢查

源碼寫1、1、1卻顯示1、2、3,插入說明後編號又重置?用短示例檢查Markdown列表的起始數字、段落和代碼塊歸屬,以及獨立列表的重新編號。

AI Lab 內容維護 · 更新於 · 約7分鐘閱讀

先看結論

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 導出檢查流程覈對。只有最終閱讀位置的編號、層級和內容歸屬都符合預期,纔算完成這次文檔修正。

依據與進一步閱讀

外部資料用於說明格式與語法,本站步驟與限制以當前產品實現爲準,不代表第三方背書。

試着完成自己的任務

先用一份小樣本驗證流程,再處理正式文件。指南免費閱讀,工具的體驗範圍與積分價格見產品詳情。

前往相關頁面

本文由AI輔助整理,並對照本站實現覈對。例子用於說明操作,不代表所有設備與文件都已實測。反饋內容問題