This is a proof of concept project for converting CakePHP's RST documentation format to Markdown.
This project demonstrates the feasibility of migrating CakePHP's documentation from reStructuredText (RST) / Sphinx to Markdown format, making it more accessible and easier to work with modern documentation tools.
The converted markdown files have been integrated into a VitePress site for demonstration purposes. You can view the result here:
The main conversion is happening with pandoc with a bunch of added filters to make Sphinx conversion work.
Note: a large part of the conversion script was carefully prompted and generated by AI.
- Evaluate the conversion process from RST to Markdown
- Test compatibility with modern static site generators
- Explore improved documentation workflows and tooling