如何在Google Docs首个标题上方新增标题且不破坏超链接

问题背景 #

假设你有一份包含若干标题的Google Docs文档，已发送指向文档首个标题的超链接：

https://docs.google.com/document/d/AbTVfZtAPbMJeD08LDgV1QaPeQqm5giEoqoeqzgR6NHP/edit#heading=h.9thvmkhwr58r

其中，第一段随机字符串用于标识文档，第二段随机字符串h.9thvmkhwr58r是目标标题的唯一ID。需要在该标题上方插入新标题，且不改变原标题的ID。

手动操作方法 #

• 步骤1：定位目标标题
  打开文档后，通过已发送的超链接直接跳转到目标标题，或手动查找定位到该标题。
• 步骤2：插入新行
  将光标精准定位到原标题的行首，按下回车键，原标题会自动下移一行，光标停留在新生成的空白行。
• 步骤3：设置新标题格式
  在空白行输入新标题内容，通过文档顶部的格式菜单（或快捷键）将其设置为对应层级的标题样式（如一级标题、二级标题）。

⚠️ 注意：不要通过「插入」菜单添加标题，也不要删除原标题行后重新插入，这类操作会触发Google Docs重新生成原标题的ID。

编程方式（使用Google Apps Script） #

通过Google Apps Script可以精准控制插入逻辑，确保原标题ID不受影响：

示例代码 #

function insertNewTitleAboveTarget() {
  // 替换为你的文档ID和目标标题ID
  const docId = 'AbTVfZtAPbMJeD08LDgV1QaPeQqm5giEoqoeqzgR6NHP';
  const targetHeadingId = 'h.9thvmkhwr58r';
  
  const doc = DocumentApp.openById(docId);
  const body = doc.getBody();
  
  // 遍历段落查找目标标题
  let targetElement = null;
  const allParagraphs = body.getParagraphs();
  for (const para of allParagraphs) {
    if (para.getHeading() !== DocumentApp.ParagraphHeading.NORMAL && para.getAttribute('headingId') === targetHeadingId) {
      targetElement = para;
      break;
    }
  }
  
  if (targetElement) {
    // 获取目标标题的位置索引，在其上方插入新段落
    const targetIndex = body.getChildIndex(targetElement);
    const newTitlePara = body.insertParagraph(targetIndex, '新插入的标题内容');
    // 设置新段落为标题样式（这里用一级标题，可按需调整）
    newTitlePara.setHeading(DocumentApp.ParagraphHeading.HEADING1);
    
    doc.saveAndClose();
    console.log('新标题插入完成，原标题ID未变更');
  } else {
    console.log('未找到指定ID的目标标题');
  }
}

代码说明 #

1. 通过文档ID打开目标文档，遍历所有段落元素，利用headingId属性精准定位目标标题。
2. 获取目标标题在文档主体中的索引位置，调用insertParagraph在该索引处插入新段落（原标题会自动下移）。
3. 为新段落设置标题样式后保存文档，整个过程不会触发原标题ID的重新生成。

内容的提问来源于stack exchange，提问作者Mathias Rav