site: Preserve HTML lists and nested tables in docs2mdx table cells (https://github.com/bazelbuild/bazel/pull/30705) ## Summary - When `docs2mdx.py` converts HTML reference docs to MDX, table cells containing lists, nested tables, or `<pre>` blocks are now preserved as inline HTML instead of being flattened to broken markdown. - Adds `docs2mdx_test` with coverage for list-in-cell, nested-table-in-cell, and pre-in-cell cases. Fixes #30614, #30616, and contributes to #30615. **Note:** Reference docs under `docs/reference/` need to be regenerated after this lands. ## Approach `markdownify` converts `<ul>/<ol>` inside `<td>` to inline `* item` text, and nested `<table>` elements into broken pipe syntax. The fix overrides `convert_td`/`convert_th` to emit raw inner HTML for complex cells. ## Test plan ### Unit tests - [x] `bazel test //scripts/docs:docs2mdx_test //scripts/docs:rewriter_test` ### Mintlify preview Preview: https://bazel-pr-30705.mintlify.app/ | Check | URL | Expected | |-------|-----|----------| | [ ] List in cell | `/reference/be/common-definitions#common-attributes` → `aspect_hints` row | Bullet list renders (not inline `* text`) | | [ ] List in cell | same page → `tags` row | Multi-level bullet list renders | | [ ] Nested table | `/reference/be/common-definitions#common-attributes-tests` → `size` row | Inner Size/RAM/CPU table renders | | [ ] Nested table | same page → `timeout` row | Inner timeout table renders | | [ ] Code in cell | `/rules/lib/repo/http` | Attribute table not squished (#30615) | - [x] Preview deployed (bazel-docs bot comment) - [ ] Visual checks above verified in preview ### Post-merge - [ ] Regenerate reference docs and confirm on bazel.build Closes #30705. PiperOrigin-RevId: 972668092 Change-Id: I8e27931e4a4abc7466463b81aa26e7449eeb0690
{Fast, Correct} - Choose two
Build and test software of any size, quickly and reliably.
Speed up your builds and tests: Bazel rebuilds only what is necessary. With advanced local and distributed caching, optimized dependency analysis and parallel execution, you get fast and incremental builds.
One tool, multiple languages: Build and test Java, C++, Android, iOS, Go, and a wide variety of other language platforms. Bazel runs on Windows, macOS, and Linux.
Scalable: Bazel helps you scale your organization, codebase, and continuous integration solution. It handles codebases of any size, in multiple repositories or a huge monorepo.
Extensible to your needs: Easily add support for new languages and platforms with Bazel's familiar extension language. Share and re-use language rules written by the growing Bazel community.
To report a security issue, please email security@bazel.build with a description of the issue, the steps you took to create the issue, affected versions, and, if known, mitigations for the issue. Our vulnerability management team will respond within 3 working days of your email. If the issue is confirmed as a vulnerability, we will open a Security Advisory. This project follows a 90 day disclosure timeline.
See CONTRIBUTING.md
