Skip to content

Add Markdown for Agents limits note#28309

Merged
elithrar merged 1 commit intoproductionfrom
opencode/issue28308-20260212231426
Feb 13, 2026
Merged

Add Markdown for Agents limits note#28309
elithrar merged 1 commit intoproductionfrom
opencode/issue28308-20260212231426

Conversation

@ask-bonk
Copy link
Contributor

@ask-bonk ask-bonk bot commented Feb 12, 2026

The CI environment doesn't have the right Node version for full validation. The change is straightforward MDX content - a Starlight :::note admonition directive, which is standard syntax used throughout the docs.

Here's a summary of the change:

File: src/content/docs/fundamentals/reference/markdown-for-agents.mdx

Added a :::note admonition in the Limitations section documenting two conditions where Markdown for Agents will not return a converted Markdown response:

  1. The origin response does not include a content-length header.
  2. The origin response content-length exceeds 1 MB (1,048,576 bytes).

The note also clarifies that in these cases, the original HTML response is returned instead.

Closes #28308

github run

Co-authored-by: elithrar <elithrar@users.noreply.github.com>
@github-actions
Copy link
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/fundamentals/ @dcpena, @cloudflare/pcx-technical-writing

@elithrar elithrar enabled auto-merge (squash) February 12, 2026 23:55
@elithrar
Copy link
Collaborator

/bonk revalidate

@ask-bonk
Copy link
Contributor Author

ask-bonk bot commented Feb 13, 2026

The preview renders correctly. The note admonition appears properly in the Limitations section with the two bullet points clearly visible.

Validation summary:

  • npm run check: 0 errors, 0 warnings (pass)
  • Preview deployment: renders correctly, the :::note admonition displays as expected
  • Content: the note is well-structured, uses proper MDX syntax, and accurately documents the two conditions (missing content-length header, content-length > 1 MB)
  • Style: uses monospace for content-length, provides specific byte value (1,048,576) alongside human-readable "1 MB"

No issues found. This PR is ready to merge.

github run

@elithrar elithrar merged commit a264c96 into production Feb 13, 2026
12 checks passed
@elithrar elithrar deleted the opencode/issue28308-20260212231426 branch February 13, 2026 21:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

update markdown for agents docs

3 participants