Skip to content

Codex Desktop Markdown file preview fails to render local images when paths contain spaces #21707

@RintaroMasaoka

Description

@RintaroMasaoka

What version of Codex is running?

Not sure. Codex Desktop app on macOS. I could not retrieve the app version from this environment.

What platform is your computer?

macOS 26.3.1, arm64.

What issue are you seeing?

In the Codex Desktop right-side Markdown file preview pane, local image embeds fail to render when the referenced image path contains spaces. The preview leaves a blank / missing image area instead of loading the local image.

This report is specifically about rendering images inside a .md file opened in the right-side preview pane, not about clicking a file link in an assistant message.

Steps to reproduce

  1. In a Codex Desktop workspace on macOS, create a Markdown file and an image file under a path containing a space.

  2. Reference the image from the Markdown file, for example:

    ![example](./assets/my image.png)

    or with an absolute path containing a space:

    ![example](/Users/me/Desktop/My Project/assets/example.png)
  3. Open/render the .md file in the right-side preview pane.

  4. Observe that the image does not render correctly.

Expected behavior

Markdown image embeds should render correctly when the local path contains spaces, either by preserving the full path as a single local-resource path or by correctly encoding spaces as %20 before resolving the image source.

Actual behavior

The image area is blank / missing in the right-side Markdown file preview when the image path includes spaces.

Related issues checked

I found several related local path / Markdown rendering issues, but none that appear to be the exact same scope:

Additional information

This may share root cause with local-resource URL/path encoding in the Desktop app Markdown renderer. A useful control would be comparing the same image copied to a path with no spaces against the original path with spaces.

Metadata

Metadata

Assignees

No one assigned

    Labels

    appIssues related to the Codex desktop appbugSomething isn't working

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions