Assistant - Lists generated without required blank line cause incorrect rendering in Quarto
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 68/100
- Issue type
- Bug
- Clarity
- Mostly clear
- Activity status
- Quiet
- Tech stack
- markdown, typescript
Research direction
Start with extensions/positron-assistant/src/md/prompts/chat/quarto.md and review how the Quarto prompt describes Markdown list formatting. Reproduce the Ask-mode request in a .qmd file, then verify that generated lists place a blank line between the header or leading sentence and the list items, including in rendered or previewed output.
Written by the indexing model from the issue text.
Description
Assistant accidentally generates lists without a blank line between the list header and the list items. Without this blank line, Quarto does NOT render the list correctly.
Example of Incorrect Output (Generated by Assistant)
The missing blank line after the header prevents Quarto from treating the items as a proper list:
List of fruits generated by Assistant:
- Apple
- Banana
- Cherry
Properly Rendered Quarto List (Blank Line Added)
List of fruits for Quarto to render properly:
- Apple
- Banana
- Cherry
System details
Positron and OS details
Positron Version: 2025.12.0 build 91
Code - OSS Version: 1.105.0
Commit: 668a82c6f5f554181b5905d97cbc663fcf1943fc
Date: 2025-11-19T07:19:10.278Z
Electron: 37.6.0
Chromium: 138.0.7204.251
Node.js: 22.19.0
V8: 13.8.258.32-electron.0
OS: Darwin arm64 25.1.0
Session details
I did not test every single model or provider, but the issue occurs in most—if not all—model/provider combinations I tried.
Describe the issue
When asking Assistant to generate a Markdown list within a Quarto document or Notebook, it often produces the following pattern:
Header:
- Item 1
- Item 2
A newline should be inserted between the header text and the list items. Without this space, Quarto interprets the items as verbatim text rather than a list, causing incorrect rendering in both the visual editor and rendered output.
This affects usability when generating content intended for Quarto documents or R Markdown–style formatting.
Steps to reproduce the issue
- Open a Quarto (
.qmd) file or Notebook in Positron. - Ask Assistant in Ask mode to generate a list, e.g.:
“Give me a list of fruits in Markdown.”
- Observe the generated output—most of the time, the list is produced immediately after the header with no blank line.
- Render or preview the document. The list is not rendered correctly.
Expected or desired behavior
Assistant should insert a blank line after a header or leading sentence before beginning a Markdown list. For example:
Fruits:
- Apple
- Banana
- Cherry
This ensures proper rendering in Quarto. It's not a Quarto issue, since this is expected, as described in this discussion.
Potential Direction
- We possibly need to expand on this prompt https://github.com/posit-dev/positron/blob/main/extensions/positron-assistant/src/md/prompts/chat/quarto.md to capture this scenario (suggested by @sharon-wang).
- Dominant language
- TypeScript
- Stars
- 4.3k
- Forks
- 184
- Avg merge
- 1d 5h
- Merged PRs (30d)
- 186
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from posit-dev/positron
-
ci-cd lang: python
Difficulty 1/5 Under an hour Newbie friendliness 84/100
-
area: quarto lang: r
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
-
area: quarto lang: r
Difficulty 2/5 1-3 hours Newbie friendliness 84/100
-
area: onboarding area: welcome enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
-
area: assistant bug support
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
All issues in posit-dev/positron
Similar issues
-
calcite-components needs triage refactor
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
Esri/calcite-design-system#15203 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 91/100
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
Difficulty 1/5 Under an hour Newbie friendliness 95/100
-
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
Automattic/studio#4908 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 90/100