VS Code扩展配置中markdownDescription被截断，如何查看完整内容？

我的VS Code扩展配置采用对象数组形式，需手动在settings.json中修改，因此我使用markdownDescription编写设置的详细说明，但在「文件/首选项/设置」的UI界面中，描述内容被截断并以[...]结尾。

以下是package.json中的配置贡献代码：

"configuration": {
  "properties": {
    "comblocks.blockComment.styleOverrides": {
      "type": "array",
      "markdownDescription": "Style overrides providing delimiters to use for comment blocks. By default, the \n当前语言模式 determines the left and right delimiters. \nThe default top/bottom border character is a dash (`-`).\n\nAny style specifications included here will override the defaults. Each item in\nthis list has the following properties. For properties not included in the\noverride, the default will still apply.\n\n- **languageId** `{string}`  \n  Identifies the language mode to override. The list of currently installed \n  languages and their identifiers can be found in the Change Language Mode \n  (`Ctrl+K M`) dropdown.  \n  This property is required.\n\n- **left** `{string}` *optional*  \n  Character(s) used to start each line of the comment block.\n\n- **right** `{string}` *optional*  \n  Character(s) used to end each line of a the comment block.\n\n- **border** `{string}` *optional*  \n  Character to be used in creating the top/bottom borders of the comment block.\n\n- **single** `{string|string[]}` *optional*  \n  Single-line comment identifiers. These are removed from selected text before\n  building the comment block. \n\n**Predefined Overrides**\n\nThese overrides are predefined but may also be overridden with this setting.\n```json\n[\n  { \"languageId\": \"bat\",          \"left\":\":*\", \"right\":\"*\", \"single\":\":\" },\n  { \"languageId\": \"coffeescript\", \"left\":\"#*\", \"right\":\"*\" },\n  { \"languageId\": \"python\",       \"left\":\"#*\", \"right\":\"*\" },\n  { \"languageId\": \"ruby\",         \"left\":\"#*\", \"right\":\"*\" },\n  { \"languageId\": \"xml\",          \"border\":\"=\" },\n  { \"languageId\": \"xsl\",          \"border\":\"=\" }\n]\n```",
      "items": {
        "type": "object",
        "required": [
          "languageId"
        ],
        "properties": {
          "languageId": {
            "type": "string"
          },
          "left": {
            "type": "string"
          },
          "right": {
            "type": "string"
          },
          "border": {
            "type": "string"
          },
          "single": {
            "type": "string|string[]"
          }
        },
        "additionalProperties": false
      }
    }
  }
}

UI界面显示效果：

请问有没有办法查看完整的markdownDescription内容？有什么解决建议？

查看完整描述的方法 #

• 通过JSON设置视图查看：在设置UI界面中，点击配置项右侧的「编辑设置(JSON)」按钮，打开settings.json文件。将鼠标悬停在对应的配置键（如comblocks.blockComment.styleOverrides）上，VS Code会弹出完整的markdownDescription提示，不会被截断。
• 直接查看扩展的package.json文件：
  1. 打开命令面板（Ctrl+Shift+P/Cmd+Shift+P），输入「Extensions: Show Installed Extensions」找到目标扩展。
  2. 右键点击扩展，选择「在文件资源管理器中显示」，打开扩展的安装目录。
  3. 找到并打开package.json文件，搜索对应的配置项，即可查看完整的markdownDescription内容。

避免描述被截断的优化建议 #

• 拆分长描述，引导至README：将过于详细的内容（如预定义覆盖示例）移至扩展的README文件中，在markdownDescription里只保留核心说明，并提示用户查看README获取完整细节。
• 简化描述结构：尽量压缩markdownDescription的长度，减少冗余换行、简化示例，只保留最关键的配置说明，避免因内容过长触发UI截断逻辑。
• 利用子属性单独描述：对于数组中的对象属性（如languageId、left等），在items.properties中为每个子属性单独添加markdownDescription，用户在UI中展开配置项时，可查看每个子属性的详细说明，无需将所有内容堆在父配置的描述里。

内容的提问来源于stack exchange，提问作者sthames42