VSCode Markdown 插件中如何禁用有序列表自动编号功能

在 VSCode 中使用 Markdown 编写文档时，有序列表的自动编号功能有时会带来不便。本文将详细介绍如何通过配置完全控制有序列表的编号行为。

问题背景

许多 Markdown 用户在编写文档时会遇到这样的情况：即使设置了 markdown.extension.orderedList.autoRenumber 为 false，有序列表仍然会自动重新编号。这通常发生在用户希望所有列表项都显示为"1."而不是自动递增编号时。

解决方案

要实现完全禁用有序列表的自动编号功能，需要同时配置两个关键设置：

1. markdown.extension.orderedList.autoRenumber: false
2. markdown.extension.orderedList.marker: "one"

第一个设置只是禁止了自动重新编号的行为，而第二个设置则强制所有列表项都使用"1."作为编号标记。

详细配置说明

在 VSCode 的 settings.json 文件中，建议添加以下配置：

{
    "markdown.extension.orderedList.autoRenumber": false,
    "markdown.extension.orderedList.marker": "one"
}

实际效果

配置完成后，无论你输入多少个列表项，它们都会保持为"1."的编号形式，而不会自动递增。这对于需要保持统一编号的特殊文档格式特别有用。

注意事项

1. 如果只设置 autoRenumber 为 false 而不设置 marker 为 "one"，系统仍可能在某些情况下自动调整编号
2. 这些设置是全局性的，会影响所有 Markdown 文档中的有序列表行为
3. 如果需要临时恢复自动编号功能，可以临时修改这些设置

通过合理配置这两个参数，用户可以完全掌控 Markdown 有序列表的编号行为，满足各种特殊格式需求。