| feat(tools): add markdown-to-notebook converter for documentation (#5691) Depends on https://github.com/Eventual-Inc/Daft/pull/5705. Also depends on #5774. ## Summary - Add a new tool tools/convert_md_to_notebook.py that converts Markdown documentation files to Jupyter notebooks - Replace the outdated docs/quickstart.ipynb with a newly generated version at docs/notebooks/quickstart.ipynb - The converter handles MkDocs-specific syntax (admonitions, icons, grid cards) and converts them to HTML that renders properly in Colab/Jupyter ### Key features of the converter: - Automatically adds Colab badge with correct GitHub links - Converts MkDocs admonitions (!!! note, !!! tip, etc.) to styled HTML divs - Converts relative markdown links to absolute docs.daft.ai URLs - Preserves code output blocks from source markdown - Handles pip install commands by prefixing with ! - Supports --branch option for testing Colab links on feature branches - Supports --update-source flag to add Colab badge to the source markdown file ## Test plan - [x] Run the converter on docs/quickstart.md and verify the output renders correctly in Jupyter/Colab - [x] Verify admonitions render as styled HTML boxes - [x] Verify links point to correct docs.daft.ai URLs - [x] Verify Colab badge links to the correct GitHub path ## Internal https://eventualgroup.slack.com/archives/C09GQPUTXQQ/p1765225846124549 Closes EVE-1327. | 9 个月前 |