富文本笔记系统使用指南

收藏一个网页只是信息管理的第一步，将网页中的知识提炼、整理并形成自己的思考才是真正有价值的环节。MarkStackAI 内置了一套完整的富文本笔记系统，让你在同一个平台中完成从「收藏」到「消化」再到「输出」的全流程。不需要在多个工具之间切换，你的书签和笔记天然关联在一起。

编辑器与 Markdown 支持

MarkStackAI 的笔记编辑器基于成熟的富文本方案构建，提供了所见即所得的编辑体验。编辑器顶部的工具栏包含了常用的格式化操作：

文本格式：标题（H1-H6）、粗体、斜体、下划线、删除线、引用块。
列表：有序列表、无序列表、任务清单（可勾选的待办列表）。
插入元素：链接、图片、代码块、分割线、表格。
对齐方式：左对齐、居中、右对齐。

同时，编辑器也完整支持 Markdown 语法。你可以直接在编辑器中输入 Markdown 标记，系统会实时渲染为富文本。比如输入 ## 二级标题 会自动转换为标题样式，输入 **粗体文字** 会自动加粗。如果你习惯 Markdown 写作，完全可以不用工具栏，纯键盘就能完成所有排版。

笔记内容以 Markdown 格式存储在数据库中（content_md 字段），这意味着你的内容是纯文本格式，不会被专有格式锁定，随时可以导出到其他 Markdown 编辑器中使用。

笔记本分类体系

笔记通过「笔记本」来组织。你可以把笔记本理解为笔记的文件夹，每个笔记本下可以存放多篇笔记。笔记本的创建和管理都在笔记页面的左侧栏完成。

典型的笔记本分类方式包括：

按项目分：「工作项目 A」「个人项目」「学习笔记」
按主题分：「前端技术」「后端架构」「产品设计」「读书摘要」
按时间分：「2025年日记」「每周复盘」「会议记录」

点击左侧栏的笔记本名称可以快速筛选显示该笔记本下的所有笔记。未分类的笔记会出现在「全部笔记」视图中。每个笔记本可以随时重命名或删除，删除笔记本不会删除其中的笔记，它们会变成未分类状态。

标签管理

除了笔记本分类，每篇笔记还可以添加多个标签。标签是一种灵活的交叉分类方式，一篇笔记可以同时属于多个标签。

例如一篇关于「Vue 3 组件设计模式」的笔记，你可以打上「Vue」「设计模式」「前端」三个标签。之后在搜索或筛选时，任何一个标签都能帮你找到这篇笔记。

标签的添加方式很直观：在笔记编辑区域的标签栏中直接输入，用逗号分隔多个标签。已有的标签会以彩色胶囊形式展示，点击即可删除。标签在全局搜索中也可以作为筛选条件使用。

图片上传

笔记中经常需要插入截图、图表或示意图。MarkStackAI 支持在笔记中上传图片，图片会存储在服务端并通过 URL 引用到笔记内容中。

上传图片有两种方式：

工具栏按钮：点击编辑器工具栏的图片按钮，选择本地文件上传。
粘贴上传：直接在编辑器中按 Ctrl+V 粘贴剪贴板中的截图，图片会自动上传并插入到光标位置。

粘贴上传尤其方便。当你截取一个界面截图或从其他应用复制了一张图片，只需要切换到笔记编辑器直接粘贴，省去了保存文件、选择文件的繁琐步骤。

代码高亮

作为一个面向技术人群的知识管理工具，代码高亮是必不可少的功能。在笔记中插入代码块后，系统会自动进行语法高亮显示，支持常见的编程语言：

// JavaScript 示例
async function fetchBookmarks(folderId) {
  const response = await api.get(`/bookmarks/tree`, {
    params: { parent_id: folderId }
  });
  return response.data;
}

在 Markdown 模式下，使用三个反引号加语言标识即可创建代码块：

```python
def health_check(url: str, timeout: int = 10) -> dict:
    """检查 URL 的健康状态。"""
    try:
        response = requests.head(url, timeout=timeout)
        return {"status": "ok", "code": response.status_code}
    except requests.Timeout:
        return {"status": "timeout"}
```

代码高亮使用经过优化的配色方案，在深色和浅色主题下都有良好的可读性。代码块还支持横向滚动，不会因为长行代码而破坏页面布局。

笔记置顶与快速访问

重要的笔记可以标记为「置顶」。置顶笔记会始终显示在笔记列表的最顶部，无论按什么排序方式，它们都不会被淹没。

这个功能非常适合放置一些经常参考的内容，比如项目的技术架构备忘、常用的命令速查表、团队规范文档等。与其每次都搜索，不如将它们固定在最上面，一眼就能看到。

搜索笔记

笔记系统内置了搜索功能，可以在笔记标题和内容中进行关键词搜索。搜索时会跳过笔记本的过滤限制，在全部笔记中进行搜索，确保不会遗漏任何匹配的结果。

搜索结果会实时更新，输入关键词后立即显示匹配的笔记列表。点击搜索结果即可打开对应的笔记进入编辑状态。

笔记分享

当你写好一篇有价值的笔记，可能想要分享给其他人。MarkStackAI 提供了笔记分享功能：点击笔记工具栏上的分享按钮，系统会生成一个分享链接并复制到剪贴板。

分享链接指向一个独立的公开页面，访问者可以查看笔记的完整内容，包括 Markdown 渲染后的富文本效果和代码高亮。不需要登录账号也能查看分享的笔记。

如果你需要取消分享，可以在笔记设置中关闭分享状态，之前的分享链接将不再可用。

发布为文章

笔记分享只是点对点的内容传播，如果你想将笔记发布到更广泛的受众面前，可以使用「发布为文章」功能。

在导航管理页面的文章管理区域，你可以：

从现有笔记中选择一篇进行发布。笔记选择器提供了双栏布局，左侧按笔记本分类筛选，右侧展示笔记列表，已发布的笔记会有标记提示。
设置文章的标题、摘要和封面图片。标题默认使用笔记标题，但你可以自定义一个更适合公开展示的标题。
选择是否置顶文章。置顶文章会在公开导航页的文章区域优先展示。

发布后的文章会出现在公开导航页的「文章专栏」区块中，任何访问你导航站的人都可以阅读。文章内容会实时同步笔记的最新版本，你在笔记中的修改会自动反映到已发布的文章上。

软删除与恢复

和书签一样，笔记的删除也是软删除。被删除的笔记会进入回收站，你可以随时恢复。删除操作需要通过确认对话框确认，防止误操作。

回收站中的笔记会显示删除时间和原所属笔记本信息，方便你定位和恢复需要的内容。

移动端适配

笔记系统在移动端也做了专门的适配。在 768px 以下的屏幕宽度中，三栏布局（笔记本目录、笔记列表、编辑器）会自动切换为上下两栏布局（笔记列表在上、编辑器在下），笔记本目录以折叠菜单的形式呈现。

编辑器的工具栏在移动端会自动换行，保证所有格式化按钮都可以触达。虽然在手机上进行长篇写作不太方便，但查看和小幅修改笔记内容完全没有问题。

小结

MarkStackAI 的笔记系统不是一个简单的附属功能，而是一个完整的知识管理解决方案。从日常的随手记录到深度的知识整理，从个人的私密笔记到公开发布的文章，它覆盖了知识工作者的核心需求。与书签系统的深度整合，让你可以在收藏的同时记录思考，在整理书签的同时沉淀知识，真正形成一个闭环的信息管理工作流。

富文本笔记系统：你的个人知识库