使用Google Apps Script将Google文档H4标题硬换行转软换行

我正在处理一份Google文档，部分H4标题被硬回车（Enter键，\n）分割成了多行，想把这些硬回车转换成软回车（Shift+Enter）。手动处理几百个这样的标题太麻烦，想用Google Apps Script自动化实现。

尝试过的代码 #

尝试1 #

function convertHeading6ToSoftWrap() {
  var body = DocumentApp.getActiveDocument().getBody();
  
  var heading4Elements = body.getParagraphs().filter(function (paragraph) {
    return paragraph.getHeading() == DocumentApp.ParagraphHeading.HEADING4;
  });

  heading4Elements.forEach(function (element) {
    var text = element.getText();
    element.clear();
    
    element.setAttributes({
      'LINE_SPACING': 1.5,
      'SPACING_AFTER': 0,
      'SPACING_BEFORE': 0
    });
    
    element.appendText(text);
  });
}

尝试2 #

function convertHeading6ToSoftWrap() {
  var body = DocumentApp.getActiveDocument().getBody();

  var heading4Elements = body.getParagraphs().filter(function (paragraph) {
    return paragraph.getHeading() == DocumentApp.ParagraphHeading.HEADING4;
  });

  heading4Elements.forEach(function (element) {
    var text = element.getText();

    element.clear();

    applySoftWrap(text, body);
  });
}


function applySoftWrap(text, body) {
  var lines = text.split("\n");

  lines.forEach(function (line, index) {
    if (index > 0) {
      body.appendParagraph(line);
    } else {
      body.appendParagraph(line);
    }
  });
}

更新：部分解决但存在问题 #

参考建议后，我写出了能将硬回车合并为软换行的H4代码，但它会把所有H4标题合并成一个，哪怕它们之间有空行或非H4段落分隔：

function convertHeading4ToSoftWrap() {
  var body = DocumentApp.getActiveDocument().getBody();

  var paragraphs = body.getParagraphs();
  var mergedText = '';
  var isFirstHeading4 = true;

  paragraphs.forEach(function (paragraph) {
    try {
      if (paragraph.getHeading() === DocumentApp.ParagraphHeading.HEADING4) {
        if (isFirstHeading4) {
          mergedText = paragraph.getText();
          isFirstHeading4 = false;
        } else {
          mergedText += '\n' + paragraph.getText();
          paragraph.removeFromParent(); // Remove the redundant paragraph
        }
      }
    } catch (error) {
      console.error('Error processing paragraph:', error);
    }
  });

  // Create a new paragraph with the merged Heading 4 text
  var mergedParagraph = body.appendParagraph(mergedText);

  // Set the new paragraph as Heading 4
  mergedParagraph.setHeading(DocumentApp.ParagraphHeading.HEADING4);
}

要解决这个问题，核心是识别连续的H4段落组，每组内的H4合并为单个带软回车的H4，不同组之间保留分隔。以下是修正后的代码：

function convertH4HardBreaksToSoft() {
  const doc = DocumentApp.getActiveDocument();
  const body = doc.getBody();
  const paragraphs = body.getParagraphs();
  let currentH4Group = [];

  // 遍历所有段落，分组连续的H4
  for (let i = 0; i < paragraphs.length; i++) {
    const para = paragraphs[i];
    if (para.getHeading() === DocumentApp.ParagraphHeading.HEADING4) {
      currentH4Group.push(para);
    } else {
      // 遇到非H4段落，处理当前H4组
      if (currentH4Group.length > 1) {
        mergeH4Group(currentH4Group);
      }
      currentH4Group = [];
    }
  }
  // 处理文档末尾的H4组
  if (currentH4Group.length > 1) {
    mergeH4Group(currentH4Group);
  }
}

function mergeH4Group(h4Group) {
  // 保留第一个H4段落，合并其他段落的内容为软回车
  const firstPara = h4Group[0];
  let mergedText = firstPara.getText();

  // 从第二个段落开始处理
  for (let i = 1; i < h4Group.length; i++) {
    const para = h4Group[i];
    // 用软回车（\v）连接内容，Google Docs中软回车对应垂直制表符
    mergedText += '\v' + para.getText();
    // 删除多余的段落
    para.removeFromParent();
  }

  // 清空第一个段落并重新插入合并后的文本
  firstPara.clear();
  firstPara.appendText(mergedText);
  // 确保保留H4格式
  firstPara.setHeading(DocumentApp.ParagraphHeading.HEADING4);
}

代码说明 #

1. 分组逻辑：遍历段落时，将连续的H4段落归为一组，遇到非H4段落时处理当前组，避免合并不连续的H4。
2. 软回车实现：Google Docs中软回车对应的是垂直制表符（\v），而非普通换行符（\n），这是之前代码失效的关键原因。
3. 保留格式：只删除多余的H4段落，保留第一个段落并重新设置内容，确保H4格式不变。

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