Skip to content

Incorrect rendering of Markdown bullet lists in SpecLynx VS Code Extension #31

Description

@DavidBiesack

Describe the bug

I have an OpenAPI 3.1 document with a bullet list in the OpenAPI info.description.
When I preview the API doc in the SpecLynx extension in VScode, the bullet list is not rendered as a bullet list; the text flows into a single paragraph

To Reproduce

I'm unable to reproduce this with a small sample - it only manifests on a larger OpenAPI document which is confidential, so I cannot upload it here. but essentially my file has a Markdown bullet list in the
info.description, as in the sample below.

Markdown:

openapi: 3.1.0
info:
  version: '0.1.0'
  title: Sample API
  description: >-
    Sample API to demonstrate SpecLynx render problem.


    Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. 
    Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. 
    Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.
    Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.


    Here is a paragraph with a bullet list:
      * item 1 with a long description that wraps to the next line; semicolon is used to separate the text clauses.
      * item 2
      * item 3
      * item 4

    Another paragraph.
    
paths:
  '/':
    get:

(this sample renders OK in the SpecLynx preview, but in my fuller OpenAPI file, it does not)

Expected behavior

I expect to see a bullet list. This is the correct rendering with the above sample:

Image

The SpecLinks editor demo does not have this problem

Screenshots

Instead, the text flows into a single paragraph.
Incorrectly rendered Markdown list:

Image

SpecLynx OpenAPI Toolkit version (please complete the following information):

  • version: 1.5.3

Environment:

  • OS: macOS
  • Version: 26.5.1 (25F80)
  • VSCode:
    • Version: 1.124.2 (Universal)
    • Commit: 6928394f91b684055b873eecb8bc281365131f1c
    • Date: 2026-06-12T00:12:36Z
    • Electron: 42.2.0
    • ElectronBuildId: 14159160
    • Chromium: 148.0.7778.97
    • Node.js: 24.15.0
    • V8: 14.8.178.14-electron.0
    • OS: Darwin arm64 25.5.0

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions