gogcli Docs 结构提取与 Markdown 互转：structure 和 headings 命令快速上手指南

gogcli Docs 结构提取与 Markdown 互转structure 和 headings 命令快速上手指南【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcligogcli 是一个在终端里管理 Google Workspace 的命令行工具其中的gog docs structure和gog docs headings list命令可以快速提取 Google Docs 文档结构并配合write、export命令实现 Google Docs 与 Markdown 之间的双向互转。本文将带你用这几条命令完成看骨架、抓标题、导出改、再回写的完整工作流。为什么需要先看清文档结构Google Docs 是富文本文档标题、正文、表格、列表混排在一起。在批量修改、生成目录、或把文档搬进 Markdown 仓库之前你往往需要先回答两个问题 文档里每一段是什么类型在第几个位置 所有标题Heading分别是什么、在什么层级gog docs structure和gog docs headings list正好分别回答这两个问题。一键查看文档骨架gog docs structuregog docs structure会把整篇文档摊开成一张带编号的段落表gog docs structure docId输出包含三列编号#、类型TYPE、内容CONTENT。每个段落都有稳定编号标题会标注层级表格会显示成[table 5x3]这样的摘要列表项会带上缩进和*前缀。编号超过 60 字符的段落会自动截断所以它特别适合快速扫一遍长文档而不必逐屏滚动。常用搭配场景命令要点只看某个标签页多标签文档加--tab Notes按标题或 ID 定位脚本化处理加--json直接拿到结构化 JSON管道里做表格处理加--plain输出无表头 TSV实现代码在 internal/cmd/docs_read.go 的DocsStructureCmd中命令页文档见 docs/commands/gog-docs-structure.md。快速抓取标题清单gog docs headings list如果你只关心这篇文档有哪些章节用headings list更聚焦gog docs headings list docId两个实用技巧按层级过滤--level 2只返回二级标题适合生成目录或大纲视图拿到 headingIdJSON 输出中每个标题带有headingId它可以直接拼成#headingid形式的文档内跳转链接方便做自动化批注或导航。命令支持--tab、--json、--plain与structure行为一致。详细说明见 docs/commands/gog-docs-headings-list.md枚举逻辑在 internal/cmd/docs_enumerators.go。Google Docs 转 Markdown两种导出方式有了骨架和标题清单下一步通常是想把内容带进 Markdown 工作流。gogcli 提供两条路径1. 完整导出gog docs exportgog docs export docId --format md --out report.mdexport支持pdf、docx、txt、md、html五种格式默认 pdf加--tab还能只导出指定标签页。适合整篇搬家。2. 轻量读取gog docs cat只想在终端里快速读一遍纯文本gog docs cat docId它把文档打印为纯文本加--numbered可显示段落编号与structure的编号体系呼应加--chips可把智能标签和文本链接渲染进输出。Markdown 转 Google Docsgog docs write --markdown反向更实用——把本地 Markdown 直接写成 Google Docs 格式# 追加在文档末尾追加一段 Markdown gog docs write docId --append --markdown --text ## Status # 替换用本地文件重渲染整篇文档 gog docs write docId --replace --markdown --file README.md内置的本地 Markdown 渲染器会处理标题、列表、表格、围栏代码块等结构标题会保持与其后正文相邻代码块使用 Roboto Mono 深色文字样式。加--check-orphans还能在替换前做预检避免未解决的评论引文因正文被重写而丢失。完整写法见 docs/docs-editing.md命令页见 docs/commands/gog-docs-write.md。组合实战三步完成导出—修改—回写把上面的命令串起来就是一条完整的文档同步流水线摸清结构gog docs structure docIdgog docs headings list docId --level 2确认章节骨架和表格位置导出为 Markdowngog docs export docId --format md --out report.md --overwrite在本地用你熟悉的编辑器或脚本修改回写 Google Docsgog docs write docId --replace --markdown --file report.md一键重渲染格式自动还原。全程无需打开浏览器配合--dry-run预览、--readonly只读保护在 CI 或脚本环境里也能安全运行。相关文档与源码结构命令文档docs/commands/gog-docs-structure.md标题清单命令文档docs/commands/gog-docs-headings-list.mdDocs 编辑总览写 Markdown / 格式 / 表格 / 页眉页脚docs/docs-editing.md导出命令docs/commands/gog-docs-export.md纯文本读取docs/commands/gog-docs-cat.md写入命令docs/commands/gog-docs-write.md掌握了structure和headings两个侦察命令再配合export/write的 Markdown 互转Google Docs 在终端里就不再是黑盒而是一份可以随时读取、编辑、同步的结构化资产。【免费下载链接】gogcliGoogle Workspace in your terminal.项目地址: https://gitcode.com/GitHub_Trending/gogcl/gogcli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考