Summary

gog docs find-replace --tab=<id> --format=markdown fails with --tab is not yet supported with --format markdown in v0.14.0. Same with the deprecated --tab-id. This blocks rendering markdown into a specific tab of a multi-tab Doc.

Use case

Multi-tab Google Docs are common — e.g., a Doc with a "Submissions" tab and a separate "Tracker" tab. I want a CLI workflow that pushes markdown directly into one specific tab so a script can keep the Tracker tab in sync from a local .md file.

Today, the workaround is gog docs write --tab (plain text) and then a manual Edit > Paste from Markdown in the Docs UI to get rendered formatting. That breaks automation.

Reproduction

gog v0.14.0 (Homebrew, 2026-04-28).

# Step 1 — write a placeholder to the target tab (works)
gog docs write <DOC_ID> --tab <TAB_ID> --text "PLACEHOLDER"

# Step 2 — find-replace with markdown content fails
gog docs find-replace <DOC_ID> --tab <TAB_ID> PLACEHOLDER \
  --content-file tracker.md --format markdown
# Error: --tab is not yet supported with --format markdown

Expected

The placeholder is replaced with rendered markdown (headings, tables, bold, lists) on the specified tab — the same behavior find-replace --format markdown already provides on a Doc's default tab.

Notes

• PR fix(docs): add TabId support to markdown replace and improve error logging #517 ("fix(docs): add TabId support to markdown replace and improve error logging") was closed unmerged. This issue tracks the underlying request.
• Same gap likely applies to docs write and docs insert if they grow --format markdown support — anything accepting --tab should also accept --format markdown.