MbBookNote
插件开发中最核心的数据对象，代表一条笔记（脑图节点）。可通过 Database.getNoteById、NotebookController.focusNote、MindMapNode.note 等获取。修改后建议使用 UndoManager.undoGrouping 包裹并刷新界面。
实例成员 (Instance members)
Section titled “实例成员 (Instance members)”| 属性 | 类型 | 说明 |
|---|---|---|
noteTitle | string | 笔记标题。 |
excerptText | string | 摘录文本。 |
excerptTextMarkdown | number | 摘录文本是否为 Markdown（运行时字段，通常为 0/1）。 |
colorIndex | number | 颜色索引 (0–15)。 |
fillIndex | number | 填充类型。 |
| 属性 | 类型 | 说明 |
|---|---|---|
noteId | string | 笔记唯一 ID。 |
docMd5 | string | 来源文档 MD5。 |
notebookId | string | 所属笔记本 ID。 |
startPage / endPage | NSNumber | 摘录起止页码。 |
startPos / endPos | string | 摘录起止位置。 |
excerptPic | NSDictionary | 摘录图片信息。 |
createDate / modifiedDate | NSDate | 创建/修改时间。 |
mediaList | string | 媒体列表。 |
originNoteId | string | 原始笔记 ID（如 Evernote）。 |
mindmapBranchClose | NSNumber | 脑图分支是否折叠。 |
notesText | string | 笔记文本聚合。 |
groupNoteId | string | 分组笔记 ID。 |
comments | NSArray | 评论数组，元素为 NoteComment 结构。 |
parentNote | MbBookNote | undefined | 父笔记。 |
childMindMap | MbBookNote | undefined | 子脑图（getter 为 parentDraft）。 |
linkedNotes | NSArray | 链接的笔记。 |
childNotes | NSArray | 子笔记数组。 |
summaryLinks | NSArray | 摘要链接。 |
zLevel / hidden / toc / annotation / textFirst / groupMode / flashcard / flagged | NSNumber | 各类标志。 |
summary | boolean | 是否有摘要链接（getter hasSummaryLinks）。 |
textHighlight / options | NSDictionary | 文本高亮与选项。 |
appendTextComment
Section titled “appendTextComment”添加一条文本评论。
appendTextComment(text: string): voidParameters:
| Name | Type | Description |
|---|---|---|
text | string | 评论内容。 |
appendMarkdownComment
Section titled “appendMarkdownComment”添加一条 Markdown 格式评论。
appendMarkdownComment(text: string): voidParameters:
| Name | Type | Description |
|---|---|---|
text | string | Markdown 格式的评论内容。 |
appendNoteLink
Section titled “appendNoteLink”添加指向另一条笔记的链接。
appendNoteLink(note: MbBookNote): voidParameters:
| Name | Type | Description |
|---|---|---|
note | MbBookNote | 目标笔记对象。 |
说明：会在 comments 数组中添加一条 TextNote 类型的评论，text 字段存储格式为 marginnote4app://note/{noteId}。
添加笔记链接（历史命名；等价于“把另一条笔记作为链接加入 comments”）。
merge(note: MbBookNote): voidappendHtmlComment
Section titled “appendHtmlComment”添加 HTML 评论（已废弃，建议使用 appendMarkdownComment）。
appendHtmlComment(html: string, text: string, size: CGSize, tag: string): voidParameters:
| Name | Type | Description |
|---|---|---|
html | string | HTML 内容。 |
text | string | 纯文本内容（用于搜索等）。 |
size | CGSize | 渲染尺寸。 |
tag | string | 标签标识。 |
说明：此方法已废弃，HTML 评论不再单独存储，建议使用 appendMarkdownComment 替代。
removeCommentByIndex
Section titled “removeCommentByIndex”按索引删除一条评论。
removeCommentByIndex(index: number): voidParameters:
| Name | Type | Description |
|---|---|---|
index | number | 评论在 comments 数组中的索引。 |
clearFormat
Section titled “clearFormat”清除笔记文本格式。
clearFormat(): void粘贴（将剪贴板内容作为评论或摘录）。
paste(): voidallNoteText
Section titled “allNoteText”获取笔记全部文本（标题+摘录+评论）。
allNoteText(): stringReturn Value:
string: 聚合文本。
类成员 (Class members)
Section titled “类成员 (Class members)”createWithTitleNotebookDocument
Section titled “createWithTitleNotebookDocument”创建新笔记（类方法）。在 JS 侧通常通过全局注入的 Note 对象调用同名方法。
static createWithTitleNotebookDocument(title: string, notebook: MbTopic, document: MbBook): MbBookNote创建新笔记的方法不在 MbBookNote 类上，而是在全局注入的 Note 对象上：
- Note —
Note.createWithTitleNotebookDocument(title, notebook, doc)
其他常用实例方法
Section titled “其他常用实例方法”| 方法 | 说明 |
|---|---|
removeFromParent() | 从父节点移除。 |
insertChildBefore(note, beforeNote) | 在指定子节点前插入。 |
addChild(note) | 添加子节点。 |
processMarkdownBase64Images() | 处理 Markdown 中的 base64 图片（按运行时实现）。 |
sortCommentsByNewIndices(newIndices) | 按新索引数组重排 comments。 |
getDrawingSize() / getStrokesCount() | 绘制相关信息（按运行时实现）。 |
realGroupNoteIdForTopicId(topicid) | 获取分组笔记在指定笔记本下的真实 ID。 |