跳到主要内容

ConvertDocument

将文档转换为 Markdown 或 HTML 文本。

语法

expression.ConvertDocument(convertType, htmlHeadings, base64img, demoteHeadings, renderHTMLTags);

expression - 表示 Api 类的变量。

参数

名称必需/可选数据类型默认值描述
convertType可选"markdown" | "html""markdown"转换类型。
htmlHeadings可选booleanfalse定义当目标平台的 Markdown 渲染器不处理 Markdown 样式 ID 时,是否生成 HTML 标题和 ID。
base64img可选booleanfalse定义图像是否以 base64 格式创建。
demoteHeadings可选booleanfalse定义文档中的所有标题级别是否将降级以符合以下标准:单个 H1 作为标题,H2 作为正文中的顶级标题。
renderHTMLTags可选booleanfalse定义 HTML 标签是否将保留在 Markdown 中。如果只想偶尔使用 HTML 标签,可以通过以下方式避免使用左尖括号:<tag>text</tag>。默认情况下,左尖括号将被替换为特殊字符。

返回值

string

示例

此示例展示如何获取 Markdown 格式的文档并将结果粘贴到文档中。

// This example shows how to convert a document to Markdown format and insert the result into the document.

// Adds a text with different heading levels to the document, converts it to Markdown, and pastes it back into the document.

// How to convert a document with different heading levels and bold text to Markdown.

let doc = Api.GetDocument();
let paragraph = doc.GetElement(0);
paragraph.AddText("Heading 1");
paragraph.SetStyle(doc.GetStyle("Heading 1"));

paragraph = Api.CreateParagraph();
paragraph.AddText("This document will be converted to Markdown.");
doc.Push(paragraph);
paragraph.Search("Markdown")[0].SetBold(true);

paragraph = Api.CreateParagraph();
paragraph.AddText("Heading 2");
doc.Push(paragraph);
paragraph.SetStyle(doc.GetStyle("Heading 2"));

paragraph = Api.CreateParagraph();
paragraph.AddText("There is an example of two heading levels.");
doc.Push(paragraph);

let md = Api.ConvertDocument("markdown", false, false, true, false);
paragraph = Api.CreateParagraph();
paragraph.AddLineBreak();
paragraph.AddText("Markdown").SetBold(true);
paragraph.AddLineBreak();
paragraph.AddText(md);
doc.Push(paragraph);