codex - 💡(How to fix) Fix Codex Desktop: support deep links to Markdown headings from chat and rendered docs

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Root Cause

We are using gpt/models/*.md files as durable design models and commit-note references. Codex chat can already provide useful clickable file links, but without heading support, model docs become harder to navigate as they grow.

This would make model-heavy workflows much better: Codex could draft a note in chat with deep links to exact model sections, then publish those same links into the docs.

RAW_BUFFERClick to expand / collapse

Bug / Feature Request

Codex Desktop renders local Markdown file links from chat well enough to open the target file, but heading anchors do not appear to work.

For example, a chat link to:

C:/Users/chris/GitHub/service-gpt-copy-paste/gpt/models/container-part.model.md#preconditions

opens the Markdown file, but does not navigate to the ## Preconditions heading. The same problem appears inside rendered Markdown docs themselves: links from a table of contents to headings in the same document do not jump to the target section.

Expected Behavior

Markdown links with heading fragments should navigate to the heading target:

  • From Codex chat into a local Markdown file heading.
  • From one local Markdown doc to another local Markdown doc heading.
  • From a local Markdown doc to a heading in the same rendered doc.

Actual Behavior

The file opens, but the #heading-fragment is ignored.

Why This Matters

We are using gpt/models/*.md files as durable design models and commit-note references. Codex chat can already provide useful clickable file links, but without heading support, model docs become harder to navigate as they grow.

This would make model-heavy workflows much better: Codex could draft a note in chat with deep links to exact model sections, then publish those same links into the docs.

Example Workflow

A commit note includes links to sections such as:

  • Container Part Model
  • Preconditions
  • STL Name Basis
  • STL Argument Order
  • JS Overload Names
  • Member Index
  • Lexeme Index

Each item should link directly to its section in gpt/models/container-part.model.md.

Environment

  • Codex Desktop app
  • Windows
  • Local workspace Markdown files
  • Links generated from Codex chat and from rendered Markdown docs

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Codex Desktop: support deep links to Markdown headings from chat and rendered docs