gog-docs-write.md

gog docs write

Generated from gog schema --json. Do not edit this page by hand; run make docs-commands.

Write content to a Google Doc

Usage

gog docs (doc) write <docId> [flags]

Parent

• gog docs

Flags

Flag	Type	Default	Help
--access-token	string		Use provided access token directly (bypasses stored refresh tokens; token expires in ~1h)
-a --account --acct	string		Account email, alias, or auto for authenticated Google API commands
--alignment	string		Paragraph alignment: left, center, right, justify, start, end, justified
--append	bool		Append instead of replacing the document body
--batch	string		Append requests to a persisted Docs batch instead of submitting
--bg-color	string		Text background color as #RRGGBB or #RGB
--bold	bool		Set bold
--bullet-preset	string		Create a list with a Google Docs bullet glyph preset
--bullets	bool		Create a bulleted list with the default disc preset
--check-orphans	bool		Block markdown replacement when open comment quotes would disappear
--client	string		OAuth client name (selects stored credentials + token bucket)
--code	bool		Apply code style (Courier New + grey background)
--color	string	auto	Color output: auto|always|never
--disable-commands	string		Comma-separated list of disabled commands; dot paths allowed
-n --dry-run --dryrun --noop --preview	bool		Do not make changes; print intended actions and exit successfully
--enable-commands	string		Comma-separated list of enabled command prefixes; dot paths allowed (restricts CLI)
--enable-commands-exact	string		Comma-separated list of exact enabled commands; dot paths allowed and parent commands do not enable children
--file	string		Text file path ('-' for stdin)
--font-family	string		Font family, for example Arial or Georgia
--font-size	float64		Font size in points
-y --force --assume-yes --yes	bool		Skip confirmations for destructive commands
--gmail-no-send	bool	false	Block Gmail send operations (agent safety)
--heading-level	*int		Set paragraph named style to HEADING_1..HEADING_6 (shortcut for --named-style=HEADING_N)
-h --help	kong.helpFlag		Show context-sensitive help.
--home	string		Override gogcli config/data/state/cache root (equivalent to GOG_HOME)
--indent-end	*float64		Paragraph end indentation in points
--indent-first-line	*float64		Paragraph first-line indentation in points
--indent-start	*float64		Paragraph start indentation in points
--italic	bool		Set italic
-j --json --machine	bool	false	Output JSON to stdout (best for scripting)
--keep-lines-together	*bool		Keep all paragraph lines on one page or column when possible; use --no-keep-lines-together to clear
--keep-with-next	*bool		Keep the paragraph with the next paragraph when possible; use --no-keep-with-next to clear
--line-spacing	float64		Paragraph line spacing percentage, for example 100 or 150
--margin-bottom	string		Set bottom page margin (points by default; supports pt, in, cm, mm)
--margin-left	string		Set left page margin (points by default; supports pt, in, cm, mm)
--margin-right	string		Set right page margin (points by default; supports pt, in, cm, mm)
--margin-top	string		Set top page margin (points by default; supports pt, in, cm, mm)
--markdown	bool		Convert markdown to Google Docs formatting (requires --replace or --append)
--named-style	string		Set paragraph named style: NORMAL_TEXT, TITLE, SUBTITLE, HEADING_1..HEADING_6
--no-bold	bool		Clear bold
--no-bullets	bool		Remove bullets or numbering
--no-input --non-interactive --noninteractive	bool		Never prompt; fail instead (useful for CI)
--no-italic	bool		Clear italic
--no-strikethrough --no-strike	bool		Clear strikethrough
--no-underline	bool		Clear underline
--ordered	bool		Create a numbered list with the default decimal preset
--page-height	string		Set page height (points by default; supports pt, in, cm, mm)
--page-size	string		Named page size: A4, A5, Letter, Legal, Tabloid
--page-width	string		Set page width (points by default; supports pt, in, cm, mm)
--pageless	bool		Set document to pageless mode
-p --plain --tsv	bool	false	Output stable, parseable text to stdout (TSV; no colors)
--readonly	bool	false	Block mutating API requests at runtime; auth add also requests read-only OAuth scopes
--replace	bool		Replace all content explicitly (required with --markdown unless --append is set)
--results-only	bool		In JSON mode, emit only the primary result (drops envelope fields like nextPageToken)
--select --pick --project	string		In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands.
--space-above	*float64		Space above the paragraph in points
--space-below	*float64		Space below the paragraph in points
--spacing-mode	string		Paragraph spacing mode: NEVER_COLLAPSE or COLLAPSE_LISTS
--strikethrough --strike	bool		Set strikethrough
--tab	string		Target a specific tab by title or ID (see docs list-tabs)
--text	string		Text to write
--text-color	string		Text color as #RRGGBB or #RGB
--underline	bool		Set underline
-v --verbose	bool		Enable verbose logging
--version	kong.VersionFlag		Print version and exit
--wrap-untrusted	bool	false	In JSON/raw output, wrap fetched text fields in external untrusted-content markers

See Also

• gog docs
• Command index