写稿的人多少都经历过这种状态稿子写完了真正的沟通才刚刚开始。Word 批注小红点一多谁改的、为什么改、改完没有全靠消息列表里翻聊天记录。Notion 的逐块批注解决的就是这件事——选中一句话直接挂评论、负责人、回复讨论、改完标记解决所有审稿反馈跟文本块绑定在一起。而 VS Code 的 Markdown 编辑器则是把写作端从在线富文本的渲染延迟里解放出来本地纯文本编辑、语法高亮、实时预览、批量替换写完再进协作系统。标题里那句“年轻人的第一手审稿神器”指的就是这套组合Notion 管审稿VS Code 管写作中间用 Markdown 串起来。先快速看一下这套方案的核心能力。Notion 逐块批注核心是“评论跟块绑定”每一个段落、标题、列表项都可以拥有独立的评论线程支持 提及成员、通知提醒、评论回复、标记已解决审稿过程完整留痕VS Code 的 Markdown 编辑器核心是语法高亮、快捷键、内置预览、插件生态配合 markdownlint、Paste Image 这类插件本地写作可以做到接近生产线级别的可控。硬件门槛基本可以忽略Notion 是网页/客户端服务VS Code 是免费编辑器4GB 内存的旧笔记本也能流畅用。这篇文章会一步步带你配置一套完整的 VS Code Markdown 写作环境再在 Notion 里搭一个带逐块批注的审稿页面然后把两者串成“本地写稿 - 同步 Notion - 批注审稿 - 修订定稿”的协作闭环最后用一个 Notion API 调用示例说明怎么把评论批量拉回本地做统计。适合需要频繁处理稿件、评审技术文档、组织内容协作的个人和团队。1. 核心能力速览能力项说明项目类型工具链组合Notion 协作审稿 VS Code Markdown 本地写作Notion 批注能力逐块评论、 提及成员、回复讨论、解决归档、通知提醒VS Code 写作能力Markdown 语法高亮、内置预览、快捷键操作、插件扩展主要解决场景稿件评审、技术文档协作、多人修改意见汇总、版本定稿推荐硬件低门槛4GB 内存即可流畅运行 VS CodeNotion 依赖网络连接支持平台NotionWeb、Windows、macOS、iOS、AndroidVS CodeWindows、macOS、Linux启动方式Notion 直接登录工作区VS Code 安装后打开 Markdown 文件即可是否支持 APINotion 提供官方 Notion API可编程读取页面、评论、成员状态是否支持批量任务VS Code 支持多文件搜索替换、Markdown 批量格式化Notion API 支持批量查询评论适合场景技术博主写稿审稿、团队文档协作、外部顾问评审、内容编辑内部校对这套组合的核心价值不是某个单点功能多强而是把“写作”和“审稿”拆成两个独立环节各自用趁手的工具。VS Code 负责把初稿写干净Notion 负责把意见收拢中间用 Markdown 作为通用格式不锁死在任何一个编辑器里。2. 适用场景与使用边界2.1 适合谁最典型的用户是这几类技术博主、技术文档维护者、内容团队的编辑和评审、需要外包或跨部门审稿的项目负责人。比如你写了一篇技术教程想要让两三个同事分别从技术准确性、表达流畅度、格式规范三个角度给意见用 Notion 的逐块批注每个人在对应段落下评论意见天然分组不会混在一起。VS Code 的作用在写作阶段更明显——长文写作时本地编辑器响应快、不用受网页加载影响markdownlint 还能实时提示 Markdown 语法问题比如标题层级跳跃、列表符号不统一、行尾多余空格这些在发布到博客后才会暴露的小问题在写作阶段就被拦住了。2.2 不适合什么场景这套组合不适合实时强同步的在线协同编辑。如果团队习惯多人同时在同一个文档里改内容Notion 虽然支持多人同时编辑但体验不如 Google Docs 或飞书文档那种光标级协同顺畅。这里更适合“先写完再审稿”的流程而不是“边开会边改稿”。另外如果你只需要一个极简的本地 Markdown 编辑器不涉及多人协作安装 VS Code 加插件属于略显重直接用 Typora 或 Mark Text 更轻。2.3 隐私、版权与合规边界审稿场景会涉及未发布的稿件内容尤其技术文档、商业文案可能包含内部信息或客户敏感信息。在使用 Notion 时要确认工作区的访问权限设置避免把内部页面开放给外部访客。用 Notion API 拉取评论时只申请必要的权限范围不要用全量 workspace 权限。评论区里的意见如果需要截图、转发给外部人员务必先脱敏移除内部代号、人名、涉及客户的信息。稿件引用他人内容时在 Notion 审稿阶段就标注来源避免发布时遗漏版权信息。3. 环境准备与前置条件3.1 注册与安装清单这套流程需要两个基础环境一个可访问 Notion 的账号一个可运行的 VS Code 编辑器。Notion 账号访问 Notion 官网注册个人使用选免费版即可免费版支持无限页面和基础评论功能足够审稿流程使用。VS Code从官网下载对应系统版本Windows 用户注意选择 User Installer 还是 System Installer推荐 User Installer不需要管理员权限。Markdown 辅助工具如果你需要本地预览图片、导出 PDF可以额外安装 VS Code 插件后文会列具体清单。3.2 VS Code 安装检查安装完成后打开 VS Code按CtrlShiftX打开扩展面板搜索 “Markdown”先确认内置的 Markdown 语言支持是否已经启用。VS Code 从 1.x 版本开始内置了 Markdown 预览功能不需要装基础插件就能看到渲染效果。在扩展面板里可以看到已安装的扩展列表确认vscode.markdown-language-features处于启用状态。验证是否正常新建一个test.md文件写入几行带#标题、-列表、\按CtrlShiftV打开预览。如果右侧出现对应的 HTML 渲染结果说明内置编辑器已经工作。3.3 Notion 工作区准备登录 Notion 后建议先创建一个独立的页面用于测试不要直接在团队主页面里建。测试页面可以命名为“审稿测试页”以后每个稿件项目可以复制这个模板。Notion 的页面默认是空白的第一行输入/page可以创建子页面输入/callout可以创建提示框。模板的作用是统一格式比如固定写“稿件信息”“评审意见汇总”“参考文献”三块结构。3.4 网络和环境说明Notion 是云端服务需要稳定的网络连接VS Code 完全本地运行断网也能写作。如果你所在环境网络受限Notion 登录不了就只能在本地写作审稿流程可以改为“导出 Markdown - 发给评审人 - 手工汇总意见”效率会低一些但不影响写作部分。更稳妥的做法是写作阶段完全不依赖 Notion等稿子写完再一次性同步上去。4. Notion 逐块批注审稿工作流4.1 创建标准审稿页面登录 Notion创建一个空白页面命名为“稿件审稿中心”。在页面内用/heading创建三个分区稿件信息记录标题、作者、版本号、截止时间。正文区粘贴或导入 Markdown 原文。评审意见汇总用提及和评论内容留痕。正文区建议导入 Markdown 而不是直接粘贴富文本。因为 Markdown 在 Notion 里能以块的形式保留结构导入后每个段落、每个标题都是独立 block这样后续批注才能精准定位到单一文本块。Notion 支持直接粘贴 Markdown 内容粘贴时选择“Paste as Markdown”或直接CtrlV通常会自动转成多行文本块。4.2 在文本块上添加评论在正文区鼠标悬停到某个段落右侧会出现圆形加号或...菜单。点击展开选择 Comment右侧就会弹出评论输入框。这里的关键点Notion 的评论是绑定到当前块block的不是绑定到整篇页面。也就是说你选中第二段评论评论只在第二段下方显示不会像 Word 那样把批注挂在页面边缘。这个设计对审稿非常友好意见和原文始终粘在一起。添加评论时可以输入纯文本也可以提及成员。输入后会弹出成员列表选择需要这位评审人去处理的问题对方会收到通知。评论框还支持插入图片、表情、链接对指向参考资料很有用。4.3 用 提及分配责任人审稿流程里意见必须落到责任人否则就变成“大家看了但不知道谁改”。Notion 的 提及可以把每个意见明确指派。比如你发现“引言部分对背景交代不够清楚”在评论里张三并写明“建议补充背景段落”张三就会在通知中心看到这个任务。具体操作在评论输入框内输入选择成员然后写正文。该成员会在 Notion 的通知列表里看到这条评论并且可以直接跳转到所在页面。如果评论只是参考意见不要求立即处理可以不 人仅作为记录。4.4 回复、解决与归档评论发布后其他人可以在评论下回复形成线程。处理完某个意见后点击评论右上角的“已解决”按钮评论会转为已解决状态但依然保留在页面底部的评论历史里。这里有个常见误区已解决不是删除。如果后续需要追溯这个意见是否被完全落实可以重新打开评论历史查找。审稿收尾阶段通读一遍所有已解决评论确认没有遗漏的未解决项才算真正定稿。4.5 追踪修改记录Notion 的页面右上角有更新时间戳打开页面菜单可以看到“History”。点击历史记录可以查看每次编辑的差异对比。审稿过程中如果某一处被反复修改历史记录里能看到完整时间线。定稿前建议把评论全部解决后再做一次历史快照方便后续万一要回退版本。5. VS Code Markdown 编辑器配置与使用5.1 内置编辑能力VS Code 默认支持 Markdown 语法高亮打开.md文件后标题、加粗、链接、代码块都会带颜色区分。按CtrlShiftV打开预览面板按CtrlK V可以分屏同时看源码和渲染效果这是写作时最常用的组合键。内置编辑器还支持标题折叠鼠标移到左侧行号区域会显示折叠箭头点击可以收起整个标题下的内容对长文导航很有帮助。另一个容易被忽略的细节是VS Code 的 Markdown 预览可以直接点击预览面板里的“Open Link”跳转外部链接也可以在图片路径上右键打开本地图片调试图片路径很快。5.2 推荐插件清单插件名作用使用建议Markdown All in One自动生成目录、格式化表格、快捷键补全必备写作效率提升最明显markdownlint实时检查 Markdown 语法规范建议开启默认规则够用Paste Image剪贴板图片一键粘贴为本地文件处理配图频繁时强烈推荐Markdown Preview Enhanced增强预览效果支持导出 PDF/HTML需要导出时再装功能较重Path Autocomplete路径自动补全配合图片、附件路径使用安装方式CtrlShiftX打开扩展面板搜索插件名点击 Install。装完 Markdown All in One 后可以先试一下CtrlShiftP输入 “Markdown: Create Table of Contents”给长文自动生成目录。5.3 settings.json 配置示例VS Code 的 Markdown 相关配置可以写在用户设置或工作区设置中。按CtrlShiftP输入 “Open User Settings (JSON)”打开settings.json加入以下常用配置{ markdown.extension.toc.updateOnSave: true, markdown.extension.preview.autoShowPreviewToSide: false, markdownlint.config: { MD013: false, MD024: false }, files.eol: \n, editor.wordWrap: on, editor.renderWhitespace: all }配置说明markdown.extension.toc.updateOnSave保存文件时自动更新目录。markdown.extension.preview.autoShowPreviewToSide关掉保存后自动弹出预览避免干扰。markdownlint.config关闭 MD013单行长度限制和 MD024重复标题校验这两个规则对中文长文不太友好。files.eol统一使用换行符避免 Windows 和 macOS 同事改同一文件时出现行尾冲突。editor.wordWrap编辑区自动换行避免长段落被横向滚动条截断。5.4 常用快捷键与写作效率技巧Markdown All in One 提供了一组高频快捷键记熟之后写作基本不需要碰鼠标快捷键功能CtrlB加粗选中文本CtrlI斜体CtrlShift[/]标题降级 / 升级AltShift方向键上下移动当前行CtrlShiftP输入 Format Document格式化表格ShiftAltF格式化整个文档写作时还有一个实用技巧用CtrlShiftP输入 “Markdown: Toggle Preview”在源码和预览之间快速切换。对长文写作我更推荐分屏模式左边源码、右边预览并且打开markdown.extension.preview.autoShowPreviewToSide的关闭状态手动按CtrlK V打开分屏避免每次保存预览都抢焦点。5.5 批量替换与批处理技巧审稿意见回来后经常会出现某一类全局性的修改比如“所有标题写法统一”“所有代码块要加语言标注”。VS Code 的全局搜索替换可以快速处理这种批量任务。按CtrlShiftF打开全局搜索打开正则表达式开关输入匹配规则。例如查找所有没有标注语言的代码块开头^$替换为text需要注意这个替换会命中普通段落中的代码块标记使用前先在搜索结果里预览确认没有误伤。另一个常用场景是把中文全角括号统一为半角用正则[]([^]*)[]匹配全角括号内容再按需替换。6. 从 Markdown 到 Notion 的协作闭环6.1 为什么先用 Markdown 写审稿流程的核心是意见汇总而写作的核心是专注。在 VS Code 里用 Markdown 写能获得三件事完全本地编辑的响应速度、不会被格式调整干扰的纯文本结构、以及可复制的代码块和表格。写完后复制到 Notion 时由于 Markdown 本身就是 Notion 的底层存储格式之一粘贴后块结构基本能对齐不会像从 Word 复制过来那样出现大量嵌套无序列表。6.2 同步到 Notion 的操作方式最简单的同步方式在 VS Code 中全选 Markdown 源码CtrlA复制切到 Notion 页面在正文区粘贴。Notion 会识别 Markdown 语法把标题、列表、加粗、链接转成对应的 block。粘贴后需要快速检查两处代码块是否保留了语言标注表格是否变成单行纯文本。如果表格被拍平了可以重新粘贴或者用 Markdown 转 HTML 工具中转。长期维护的场景建议直接在 Notion 中Import支持导入 Markdown 文件。路径Notion 左侧边栏 - Settings - Import - Markdown CSV。导入后会生成一个页面把内容整体替换到审稿中心页面即可。6.3 用 Notion API 批量拉取评论Notion 官方提供了 API 接口可以读取页面下的评论。这个能力在审稿收尾时很有用把某篇稿件下所有评论一次性拉回本地统计未解决数量、按成员分组、输出评审报告。以下是一个通用调用框架需要替换成你自己的 API Key 和页面 block IDimport requests # 在 Notion 集成页面创建 API Key授权目标页面 API_KEY secret_xxxxx BLOCK_ID your-block-id HEADERS { Authorization: fBearer {API_KEY}, Notion-Version: 2022-06-28, Content-Type: application/json } # 获取某个 block 下的评论 url fhttps://api.notion.com/v1/comments?block_id{BLOCK_ID} response requests.get(url, headersHEADERS) if response.status_code 200: comments response.json()[results] for comment in comments: rich_text comment.get(rich_text, []) text .join( segment.get(plain_text, ) for segment in rich_text ) print(comment[id], text) else: print(请求失败:, response.status_code, response.text)这段代码只做了最基础的查询。实际使用时你还需要处理分页参数start_cursor、异常重试、敏感字段过滤。更稳妥的做法是先在一个测试页面验证 API Key 的权限范围再应用到正式审稿页面避免因权限配置问题导致拉取失败。6.4 审稿意见回流到本地评审人改完稿子后意见都在 Notion 评论区。如果你直接在 Notion 里改原文就不需要回流。但如果你希望把最终定稿重新导回本地存档可以选中页面内容复制到 VS Code 新的.md文件。需要提醒的是从 Notion 复制回 Markdown 时评论内容不会跟随导出需要在定稿后截图或另存评论历史。7. 常见问题与排查方法问题现象可能原因排查方式解决方案Notion 评论不显示浏览器插件拦截、网络异常检查通知中心、刷新页面无痕模式重新登录检查网络 提及不下发通知对方不在当前工作区检查成员列表是否包含对方添加成员为工作区成员后再 复制到 Notion 后表格拍平剪贴板转 HTML 时表格结构丢失查看源码是否保留表格标记用 Notion 导入功能代替粘贴VS Code 预览不刷新缓存或扩展冲突按CtrlShiftP输入 Reload重载窗口或禁用冲突扩展markdownlint 标红但语法正确规则不适用于中文查看报错规则编号在 settings.json 关闭对应规则粘贴图片不显示图片路径含空格或中文检查图片文件是否存在改用相对路径避免中文文件名Notion API 返回 401API Key 无权限检查集成是否添加该页面在页面右上角菜单连接集成长文在预览中卡顿图片过多或行数过大观察 CPU 占用拆分章节文件或关闭实时预览8. 最佳实践与使用建议8.1 模板先行不要每次新建审稿页面都从头排版。把第一章那个“稿件审稿中心”存成模板页每次复制一份。模板里固定包含稿件信息表、正文区、评审意见汇总三个分区并且在正文区顶部写一行“评审注意意见请在对应段落评论不要在页面底部集中反馈”能有效减少无效评论。8.2 统一 Markdown 规范团队协作时Markdown 规范不统一是最大的隐性成本。用 markdownlint 在本地把规范约束住在项目根目录放一个.markdownlint.json{ MD013: false, MD024: false, MD033: false }这个配置文件指定了三个免除项不限制单行长度、允许重复标题、允许内联 HTML。其他规则保持默认开启。将配置文件提交到项目仓库所有协作者打开同一个仓库时lint 规则就一致了。8.3 审稿回合要控制数量Notion 评论解决了意见“记在哪”的问题但不解决意见“太多”的问题。稿子如果一次收到几十条评论逐条处理非常累。建议按轮次审稿第一轮只改技术性硬伤第二轮看表达第三轮看格式。每一轮结束对应的评论统一解决下一轮再开新评论。避免一轮评论没处理完下一轮意见又叠加上来。8.4 评论内容要严谨评论是审稿留痕也是团队沟通的一部分。写评论时尽量客观具体“第二段的说法不准确”不如“第二段引用的数据来源不明确建议补充链接”。涉及敏感内容时不要写在评论区通过私聊或邮件沟通。所有对外发布的稿件在发布前清理一遍评论历史。8.5 定期导出审稿数据如果你负责一个内容团队可以用 6.3 节的 API 方法按周拉取所有稿件的评论统计每个评审人的参与度、每篇稿子的评论数量和解决周期。这组数据能帮你发现审稿流程的瓶颈比如某类稿件反复在同一个章节被打回说明模板或写作规范需要调整。9. 总结与下一步Notion 逐块批注 VS Code Markdown 编辑器这套组合最值得尝试的点在于它把审稿意见从“聊天记录”变成了“结构化数据”。每一条意见都锚定在原文的具体块上解决、归档、追踪都有记录结束时你可以清楚地知道这篇稿子经过了谁的手、改了多少轮。VS Code 则负责让写作过程不被打断——本地编辑、语法检查、快捷键把富文本编辑器里那些无谓的格式操作全部踢开。第一次上手优先验证三件事第一在 Notion 里把一段文字拆成多个块分别加评论确认评论确实跟块绑定而不是跟页面绑定第二在 VS Code 里安装 Markdown All in One 和 markdownlint跑通分屏预览和目录生成第三按 6.3 节的 API 示例在测试页面拉取一次评论确认接口权限和返回结构符合预期。最容易踩的坑有两个一是从 VS Code 复制大量内容到 Notion 时代码块和表格的格式可能会变形一定要在粘贴后检查二是 API 权限配置忘记在页面中连接集成会导致 401排查时优先看页面右上角的连接状态。后续可以扩展的方向把 Notion API 的评论拉取做成一个定时脚本嵌入企业微信、飞书或邮件通知每天自动汇总待办评论或者把 VS Code 的 snippets 配置好把博客常用代码块模板沉淀下来。审稿这件事工具用得对省下的全是沟通时间。建议把这套配置收藏备用下一次稿子回来的时候直接复制模板开跑。
Notion逐块批注+VS Code Markdown：打造高效审稿协作工作流
写稿的人多少都经历过这种状态稿子写完了真正的沟通才刚刚开始。Word 批注小红点一多谁改的、为什么改、改完没有全靠消息列表里翻聊天记录。Notion 的逐块批注解决的就是这件事——选中一句话直接挂评论、负责人、回复讨论、改完标记解决所有审稿反馈跟文本块绑定在一起。而 VS Code 的 Markdown 编辑器则是把写作端从在线富文本的渲染延迟里解放出来本地纯文本编辑、语法高亮、实时预览、批量替换写完再进协作系统。标题里那句“年轻人的第一手审稿神器”指的就是这套组合Notion 管审稿VS Code 管写作中间用 Markdown 串起来。先快速看一下这套方案的核心能力。Notion 逐块批注核心是“评论跟块绑定”每一个段落、标题、列表项都可以拥有独立的评论线程支持 提及成员、通知提醒、评论回复、标记已解决审稿过程完整留痕VS Code 的 Markdown 编辑器核心是语法高亮、快捷键、内置预览、插件生态配合 markdownlint、Paste Image 这类插件本地写作可以做到接近生产线级别的可控。硬件门槛基本可以忽略Notion 是网页/客户端服务VS Code 是免费编辑器4GB 内存的旧笔记本也能流畅用。这篇文章会一步步带你配置一套完整的 VS Code Markdown 写作环境再在 Notion 里搭一个带逐块批注的审稿页面然后把两者串成“本地写稿 - 同步 Notion - 批注审稿 - 修订定稿”的协作闭环最后用一个 Notion API 调用示例说明怎么把评论批量拉回本地做统计。适合需要频繁处理稿件、评审技术文档、组织内容协作的个人和团队。1. 核心能力速览能力项说明项目类型工具链组合Notion 协作审稿 VS Code Markdown 本地写作Notion 批注能力逐块评论、 提及成员、回复讨论、解决归档、通知提醒VS Code 写作能力Markdown 语法高亮、内置预览、快捷键操作、插件扩展主要解决场景稿件评审、技术文档协作、多人修改意见汇总、版本定稿推荐硬件低门槛4GB 内存即可流畅运行 VS CodeNotion 依赖网络连接支持平台NotionWeb、Windows、macOS、iOS、AndroidVS CodeWindows、macOS、Linux启动方式Notion 直接登录工作区VS Code 安装后打开 Markdown 文件即可是否支持 APINotion 提供官方 Notion API可编程读取页面、评论、成员状态是否支持批量任务VS Code 支持多文件搜索替换、Markdown 批量格式化Notion API 支持批量查询评论适合场景技术博主写稿审稿、团队文档协作、外部顾问评审、内容编辑内部校对这套组合的核心价值不是某个单点功能多强而是把“写作”和“审稿”拆成两个独立环节各自用趁手的工具。VS Code 负责把初稿写干净Notion 负责把意见收拢中间用 Markdown 作为通用格式不锁死在任何一个编辑器里。2. 适用场景与使用边界2.1 适合谁最典型的用户是这几类技术博主、技术文档维护者、内容团队的编辑和评审、需要外包或跨部门审稿的项目负责人。比如你写了一篇技术教程想要让两三个同事分别从技术准确性、表达流畅度、格式规范三个角度给意见用 Notion 的逐块批注每个人在对应段落下评论意见天然分组不会混在一起。VS Code 的作用在写作阶段更明显——长文写作时本地编辑器响应快、不用受网页加载影响markdownlint 还能实时提示 Markdown 语法问题比如标题层级跳跃、列表符号不统一、行尾多余空格这些在发布到博客后才会暴露的小问题在写作阶段就被拦住了。2.2 不适合什么场景这套组合不适合实时强同步的在线协同编辑。如果团队习惯多人同时在同一个文档里改内容Notion 虽然支持多人同时编辑但体验不如 Google Docs 或飞书文档那种光标级协同顺畅。这里更适合“先写完再审稿”的流程而不是“边开会边改稿”。另外如果你只需要一个极简的本地 Markdown 编辑器不涉及多人协作安装 VS Code 加插件属于略显重直接用 Typora 或 Mark Text 更轻。2.3 隐私、版权与合规边界审稿场景会涉及未发布的稿件内容尤其技术文档、商业文案可能包含内部信息或客户敏感信息。在使用 Notion 时要确认工作区的访问权限设置避免把内部页面开放给外部访客。用 Notion API 拉取评论时只申请必要的权限范围不要用全量 workspace 权限。评论区里的意见如果需要截图、转发给外部人员务必先脱敏移除内部代号、人名、涉及客户的信息。稿件引用他人内容时在 Notion 审稿阶段就标注来源避免发布时遗漏版权信息。3. 环境准备与前置条件3.1 注册与安装清单这套流程需要两个基础环境一个可访问 Notion 的账号一个可运行的 VS Code 编辑器。Notion 账号访问 Notion 官网注册个人使用选免费版即可免费版支持无限页面和基础评论功能足够审稿流程使用。VS Code从官网下载对应系统版本Windows 用户注意选择 User Installer 还是 System Installer推荐 User Installer不需要管理员权限。Markdown 辅助工具如果你需要本地预览图片、导出 PDF可以额外安装 VS Code 插件后文会列具体清单。3.2 VS Code 安装检查安装完成后打开 VS Code按CtrlShiftX打开扩展面板搜索 “Markdown”先确认内置的 Markdown 语言支持是否已经启用。VS Code 从 1.x 版本开始内置了 Markdown 预览功能不需要装基础插件就能看到渲染效果。在扩展面板里可以看到已安装的扩展列表确认vscode.markdown-language-features处于启用状态。验证是否正常新建一个test.md文件写入几行带#标题、-列表、\按CtrlShiftV打开预览。如果右侧出现对应的 HTML 渲染结果说明内置编辑器已经工作。3.3 Notion 工作区准备登录 Notion 后建议先创建一个独立的页面用于测试不要直接在团队主页面里建。测试页面可以命名为“审稿测试页”以后每个稿件项目可以复制这个模板。Notion 的页面默认是空白的第一行输入/page可以创建子页面输入/callout可以创建提示框。模板的作用是统一格式比如固定写“稿件信息”“评审意见汇总”“参考文献”三块结构。3.4 网络和环境说明Notion 是云端服务需要稳定的网络连接VS Code 完全本地运行断网也能写作。如果你所在环境网络受限Notion 登录不了就只能在本地写作审稿流程可以改为“导出 Markdown - 发给评审人 - 手工汇总意见”效率会低一些但不影响写作部分。更稳妥的做法是写作阶段完全不依赖 Notion等稿子写完再一次性同步上去。4. Notion 逐块批注审稿工作流4.1 创建标准审稿页面登录 Notion创建一个空白页面命名为“稿件审稿中心”。在页面内用/heading创建三个分区稿件信息记录标题、作者、版本号、截止时间。正文区粘贴或导入 Markdown 原文。评审意见汇总用提及和评论内容留痕。正文区建议导入 Markdown 而不是直接粘贴富文本。因为 Markdown 在 Notion 里能以块的形式保留结构导入后每个段落、每个标题都是独立 block这样后续批注才能精准定位到单一文本块。Notion 支持直接粘贴 Markdown 内容粘贴时选择“Paste as Markdown”或直接CtrlV通常会自动转成多行文本块。4.2 在文本块上添加评论在正文区鼠标悬停到某个段落右侧会出现圆形加号或...菜单。点击展开选择 Comment右侧就会弹出评论输入框。这里的关键点Notion 的评论是绑定到当前块block的不是绑定到整篇页面。也就是说你选中第二段评论评论只在第二段下方显示不会像 Word 那样把批注挂在页面边缘。这个设计对审稿非常友好意见和原文始终粘在一起。添加评论时可以输入纯文本也可以提及成员。输入后会弹出成员列表选择需要这位评审人去处理的问题对方会收到通知。评论框还支持插入图片、表情、链接对指向参考资料很有用。4.3 用 提及分配责任人审稿流程里意见必须落到责任人否则就变成“大家看了但不知道谁改”。Notion 的 提及可以把每个意见明确指派。比如你发现“引言部分对背景交代不够清楚”在评论里张三并写明“建议补充背景段落”张三就会在通知中心看到这个任务。具体操作在评论输入框内输入选择成员然后写正文。该成员会在 Notion 的通知列表里看到这条评论并且可以直接跳转到所在页面。如果评论只是参考意见不要求立即处理可以不 人仅作为记录。4.4 回复、解决与归档评论发布后其他人可以在评论下回复形成线程。处理完某个意见后点击评论右上角的“已解决”按钮评论会转为已解决状态但依然保留在页面底部的评论历史里。这里有个常见误区已解决不是删除。如果后续需要追溯这个意见是否被完全落实可以重新打开评论历史查找。审稿收尾阶段通读一遍所有已解决评论确认没有遗漏的未解决项才算真正定稿。4.5 追踪修改记录Notion 的页面右上角有更新时间戳打开页面菜单可以看到“History”。点击历史记录可以查看每次编辑的差异对比。审稿过程中如果某一处被反复修改历史记录里能看到完整时间线。定稿前建议把评论全部解决后再做一次历史快照方便后续万一要回退版本。5. VS Code Markdown 编辑器配置与使用5.1 内置编辑能力VS Code 默认支持 Markdown 语法高亮打开.md文件后标题、加粗、链接、代码块都会带颜色区分。按CtrlShiftV打开预览面板按CtrlK V可以分屏同时看源码和渲染效果这是写作时最常用的组合键。内置编辑器还支持标题折叠鼠标移到左侧行号区域会显示折叠箭头点击可以收起整个标题下的内容对长文导航很有帮助。另一个容易被忽略的细节是VS Code 的 Markdown 预览可以直接点击预览面板里的“Open Link”跳转外部链接也可以在图片路径上右键打开本地图片调试图片路径很快。5.2 推荐插件清单插件名作用使用建议Markdown All in One自动生成目录、格式化表格、快捷键补全必备写作效率提升最明显markdownlint实时检查 Markdown 语法规范建议开启默认规则够用Paste Image剪贴板图片一键粘贴为本地文件处理配图频繁时强烈推荐Markdown Preview Enhanced增强预览效果支持导出 PDF/HTML需要导出时再装功能较重Path Autocomplete路径自动补全配合图片、附件路径使用安装方式CtrlShiftX打开扩展面板搜索插件名点击 Install。装完 Markdown All in One 后可以先试一下CtrlShiftP输入 “Markdown: Create Table of Contents”给长文自动生成目录。5.3 settings.json 配置示例VS Code 的 Markdown 相关配置可以写在用户设置或工作区设置中。按CtrlShiftP输入 “Open User Settings (JSON)”打开settings.json加入以下常用配置{ markdown.extension.toc.updateOnSave: true, markdown.extension.preview.autoShowPreviewToSide: false, markdownlint.config: { MD013: false, MD024: false }, files.eol: \n, editor.wordWrap: on, editor.renderWhitespace: all }配置说明markdown.extension.toc.updateOnSave保存文件时自动更新目录。markdown.extension.preview.autoShowPreviewToSide关掉保存后自动弹出预览避免干扰。markdownlint.config关闭 MD013单行长度限制和 MD024重复标题校验这两个规则对中文长文不太友好。files.eol统一使用换行符避免 Windows 和 macOS 同事改同一文件时出现行尾冲突。editor.wordWrap编辑区自动换行避免长段落被横向滚动条截断。5.4 常用快捷键与写作效率技巧Markdown All in One 提供了一组高频快捷键记熟之后写作基本不需要碰鼠标快捷键功能CtrlB加粗选中文本CtrlI斜体CtrlShift[/]标题降级 / 升级AltShift方向键上下移动当前行CtrlShiftP输入 Format Document格式化表格ShiftAltF格式化整个文档写作时还有一个实用技巧用CtrlShiftP输入 “Markdown: Toggle Preview”在源码和预览之间快速切换。对长文写作我更推荐分屏模式左边源码、右边预览并且打开markdown.extension.preview.autoShowPreviewToSide的关闭状态手动按CtrlK V打开分屏避免每次保存预览都抢焦点。5.5 批量替换与批处理技巧审稿意见回来后经常会出现某一类全局性的修改比如“所有标题写法统一”“所有代码块要加语言标注”。VS Code 的全局搜索替换可以快速处理这种批量任务。按CtrlShiftF打开全局搜索打开正则表达式开关输入匹配规则。例如查找所有没有标注语言的代码块开头^$替换为text需要注意这个替换会命中普通段落中的代码块标记使用前先在搜索结果里预览确认没有误伤。另一个常用场景是把中文全角括号统一为半角用正则[]([^]*)[]匹配全角括号内容再按需替换。6. 从 Markdown 到 Notion 的协作闭环6.1 为什么先用 Markdown 写审稿流程的核心是意见汇总而写作的核心是专注。在 VS Code 里用 Markdown 写能获得三件事完全本地编辑的响应速度、不会被格式调整干扰的纯文本结构、以及可复制的代码块和表格。写完后复制到 Notion 时由于 Markdown 本身就是 Notion 的底层存储格式之一粘贴后块结构基本能对齐不会像从 Word 复制过来那样出现大量嵌套无序列表。6.2 同步到 Notion 的操作方式最简单的同步方式在 VS Code 中全选 Markdown 源码CtrlA复制切到 Notion 页面在正文区粘贴。Notion 会识别 Markdown 语法把标题、列表、加粗、链接转成对应的 block。粘贴后需要快速检查两处代码块是否保留了语言标注表格是否变成单行纯文本。如果表格被拍平了可以重新粘贴或者用 Markdown 转 HTML 工具中转。长期维护的场景建议直接在 Notion 中Import支持导入 Markdown 文件。路径Notion 左侧边栏 - Settings - Import - Markdown CSV。导入后会生成一个页面把内容整体替换到审稿中心页面即可。6.3 用 Notion API 批量拉取评论Notion 官方提供了 API 接口可以读取页面下的评论。这个能力在审稿收尾时很有用把某篇稿件下所有评论一次性拉回本地统计未解决数量、按成员分组、输出评审报告。以下是一个通用调用框架需要替换成你自己的 API Key 和页面 block IDimport requests # 在 Notion 集成页面创建 API Key授权目标页面 API_KEY secret_xxxxx BLOCK_ID your-block-id HEADERS { Authorization: fBearer {API_KEY}, Notion-Version: 2022-06-28, Content-Type: application/json } # 获取某个 block 下的评论 url fhttps://api.notion.com/v1/comments?block_id{BLOCK_ID} response requests.get(url, headersHEADERS) if response.status_code 200: comments response.json()[results] for comment in comments: rich_text comment.get(rich_text, []) text .join( segment.get(plain_text, ) for segment in rich_text ) print(comment[id], text) else: print(请求失败:, response.status_code, response.text)这段代码只做了最基础的查询。实际使用时你还需要处理分页参数start_cursor、异常重试、敏感字段过滤。更稳妥的做法是先在一个测试页面验证 API Key 的权限范围再应用到正式审稿页面避免因权限配置问题导致拉取失败。6.4 审稿意见回流到本地评审人改完稿子后意见都在 Notion 评论区。如果你直接在 Notion 里改原文就不需要回流。但如果你希望把最终定稿重新导回本地存档可以选中页面内容复制到 VS Code 新的.md文件。需要提醒的是从 Notion 复制回 Markdown 时评论内容不会跟随导出需要在定稿后截图或另存评论历史。7. 常见问题与排查方法问题现象可能原因排查方式解决方案Notion 评论不显示浏览器插件拦截、网络异常检查通知中心、刷新页面无痕模式重新登录检查网络 提及不下发通知对方不在当前工作区检查成员列表是否包含对方添加成员为工作区成员后再 复制到 Notion 后表格拍平剪贴板转 HTML 时表格结构丢失查看源码是否保留表格标记用 Notion 导入功能代替粘贴VS Code 预览不刷新缓存或扩展冲突按CtrlShiftP输入 Reload重载窗口或禁用冲突扩展markdownlint 标红但语法正确规则不适用于中文查看报错规则编号在 settings.json 关闭对应规则粘贴图片不显示图片路径含空格或中文检查图片文件是否存在改用相对路径避免中文文件名Notion API 返回 401API Key 无权限检查集成是否添加该页面在页面右上角菜单连接集成长文在预览中卡顿图片过多或行数过大观察 CPU 占用拆分章节文件或关闭实时预览8. 最佳实践与使用建议8.1 模板先行不要每次新建审稿页面都从头排版。把第一章那个“稿件审稿中心”存成模板页每次复制一份。模板里固定包含稿件信息表、正文区、评审意见汇总三个分区并且在正文区顶部写一行“评审注意意见请在对应段落评论不要在页面底部集中反馈”能有效减少无效评论。8.2 统一 Markdown 规范团队协作时Markdown 规范不统一是最大的隐性成本。用 markdownlint 在本地把规范约束住在项目根目录放一个.markdownlint.json{ MD013: false, MD024: false, MD033: false }这个配置文件指定了三个免除项不限制单行长度、允许重复标题、允许内联 HTML。其他规则保持默认开启。将配置文件提交到项目仓库所有协作者打开同一个仓库时lint 规则就一致了。8.3 审稿回合要控制数量Notion 评论解决了意见“记在哪”的问题但不解决意见“太多”的问题。稿子如果一次收到几十条评论逐条处理非常累。建议按轮次审稿第一轮只改技术性硬伤第二轮看表达第三轮看格式。每一轮结束对应的评论统一解决下一轮再开新评论。避免一轮评论没处理完下一轮意见又叠加上来。8.4 评论内容要严谨评论是审稿留痕也是团队沟通的一部分。写评论时尽量客观具体“第二段的说法不准确”不如“第二段引用的数据来源不明确建议补充链接”。涉及敏感内容时不要写在评论区通过私聊或邮件沟通。所有对外发布的稿件在发布前清理一遍评论历史。8.5 定期导出审稿数据如果你负责一个内容团队可以用 6.3 节的 API 方法按周拉取所有稿件的评论统计每个评审人的参与度、每篇稿子的评论数量和解决周期。这组数据能帮你发现审稿流程的瓶颈比如某类稿件反复在同一个章节被打回说明模板或写作规范需要调整。9. 总结与下一步Notion 逐块批注 VS Code Markdown 编辑器这套组合最值得尝试的点在于它把审稿意见从“聊天记录”变成了“结构化数据”。每一条意见都锚定在原文的具体块上解决、归档、追踪都有记录结束时你可以清楚地知道这篇稿子经过了谁的手、改了多少轮。VS Code 则负责让写作过程不被打断——本地编辑、语法检查、快捷键把富文本编辑器里那些无谓的格式操作全部踢开。第一次上手优先验证三件事第一在 Notion 里把一段文字拆成多个块分别加评论确认评论确实跟块绑定而不是跟页面绑定第二在 VS Code 里安装 Markdown All in One 和 markdownlint跑通分屏预览和目录生成第三按 6.3 节的 API 示例在测试页面拉取一次评论确认接口权限和返回结构符合预期。最容易踩的坑有两个一是从 VS Code 复制大量内容到 Notion 时代码块和表格的格式可能会变形一定要在粘贴后检查二是 API 权限配置忘记在页面中连接集成会导致 401排查时优先看页面右上角的连接状态。后续可以扩展的方向把 Notion API 的评论拉取做成一个定时脚本嵌入企业微信、飞书或邮件通知每天自动汇总待办评论或者把 VS Code 的 snippets 配置好把博客常用代码块模板沉淀下来。审稿这件事工具用得对省下的全是沟通时间。建议把这套配置收藏备用下一次稿子回来的时候直接复制模板开跑。
