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:
The SpecLinks editor demo does not have this problem
Screenshots
Instead, the text flows into a single paragraph.
Incorrectly rendered Markdown list:
SpecLynx OpenAPI Toolkit version (please complete the following information):
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
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:
(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:
The SpecLinks editor demo does not have this problem
Screenshots
Instead, the text flows into a single paragraph.
Incorrectly rendered Markdown list:
SpecLynx OpenAPI Toolkit version (please complete the following information):
Environment: