Render code blocks properly in OpenAPI

[Jefftree]

Render code blocks properly in OpenAPI.

Partially solves kubernetes/website#35712

/cc @sftim @robert-cronin
/assign @jpbetz @sttts

k/k OpenAPI diff can be seen here kubernetes/kubernetes@7e24dab#diff-9f4c1466e676f9e733cae72d369ffd5ff37f446116c98562807cf3bfb872ae95

[k8s-ci-robot]

@Jefftree: GitHub didn't allow me to request PR reviews from the following users: robert-cronin.

Note that only kubernetes members and repo collaborators can review this PR, and authors cannot review their own PRs.

In response to this:

Render code blocks properly in OpenAPI.

Partially solves kubernetes/website#35712

/cc @sftim @robert-cronin
/assign @jpbetz @sttts

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: Jefftree

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• OWNERS [Jefftree]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[sftim]

Do we want to handle code blocks inside block quotes? I imagine not, but we might do. Calling this out as a case we could choose to handle.

[Jefftree]

The motivation was code blocks but imo anything within the block quote ``` should NOT be interpreted as markdown and should be outputted as is with no reformatting done. That's essentially what this PR is targeting

[sftim]

Markdown blockquotes look like:

> This is a block quote
> 
> Within the block quote there could be a multiline code snippet
> ```
> echo "Hello, world
> ```

[Jefftree]

Ah sorry I mixed up the terminology.

I'm not sure if we have any examples of use cases with blockquotes, so right now I'm leaning probably not. We can re-evaluate if we see a future use case.