Summary
google_docs_create_document currently creates a title-only document. Add an initial_content (Markdown) path that produces a richly formatted Doc — headings, tables, code blocks, footnotes — by uploading to Drive with convert=true rather than a naive text insert.
Decision (2026-07-30)
Ship rich-Markdown creation behind an optional extra — apron-tools[docs-rich], providing pypandoc — matching the per-provider extras pattern so the core install stays light and the feature activates only when the extra is installed.
- Note:
pypandoc requires the Pandoc binary present at runtime; document this requirement.
- When the extra is absent,
google_docs_create_document keeps its current title-only behavior (a plain-text fallback is acceptable but not required).
Scope
Existing Docs/Drive write scope.
Summary
google_docs_create_documentcurrently creates a title-only document. Add aninitial_content(Markdown) path that produces a richly formatted Doc — headings, tables, code blocks, footnotes — by uploading to Drive withconvert=truerather than a naive text insert.Decision (2026-07-30)
Ship rich-Markdown creation behind an optional extra —
apron-tools[docs-rich], providingpypandoc— matching the per-provider extras pattern so the core install stays light and the feature activates only when the extra is installed.pypandocrequires the Pandoc binary present at runtime; document this requirement.google_docs_create_documentkeeps its current title-only behavior (a plain-text fallback is acceptable but not required).Scope
Existing Docs/Drive write scope.