Skip to content

Windows: Markdown frontmatter not parsed when file uses CRLF or UTF-8 BOM (description not displayed) #2053

@jason07289

Description

@jason07289

What happened?

On Windows, custom command descriptions defined in Markdown frontmatter are not displayed correctly.

Instead of showing the description value from the YAML frontmatter, the UI displays the generic message: 'Custom command from {{filename}}.md' For example: 'Custom command from deploy.md'

The same .md file works correctly on macOS, where the description field is properly parsed and displayed.

Observed behavior

When creating a custom command file such as:

~/.qwen/commands/deploy.md

With the following content:

---
description: Deploy the app to staging
---

Run the deployment script with {{args}}.

On Windows:

The description is not shown.

The UI falls back to the default message.

Likely cause

There appear to be two Windows-specific issues:

CRLF line endings (\r\n)

The frontmatter regex in
packages/cli/src/services/markdown-command-parser.ts

It seems to match only LF (\n) line endings.

On Windows, files typically use CRLF (\r\n), causing the regex to fail and preventing frontmatter parsing.

UTF-8 BOM

If the file is saved with a UTF-8 BOM, the content begins with \uFEFF.

Since the parser expects ^---, the BOM prevents the pattern from matching.

As a result, frontmatter (including description) is not recognized.

What did you expect to happen?

The CLI should correctly parse YAML frontmatter on Windows, regardless of:

Line ending style (LF or CRLF)

Presence of a UTF-8 BOM

The description value from frontmatter should be displayed in the UI exactly as it is on macOS.

Client information

OS: Windows 11

File encoding: UTF-8 (with BOM in some cases)

Line endings: CRLF (\r\n)

Version: (please fill in your CLI/app version here)

Login information

No response

Anything else we need to know?

No response

Metadata

Metadata

Assignees

No one assigned

    Labels

    status/needs-triageIssue needs to be triaged and labeledtype/bugSomething isn't working as expected

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions