博客园 VSCode 插件工作空间及随笔管理指南

博客园 VSCode 插件工作空间及随笔管理指南

一、配置工作空间路径

1. 在你想存放博客文件的磁盘新建文件夹
   例如：D:\Cnblogs 或 E:\MyBlogs

2. 打开 VSCode

   • 选择“文件” > “打开文件夹”（或快捷键 Ctrl+K Ctrl+O）

   • 选择刚才新建的文件夹作为工作空间打开

3. 设置插件识别的工作空间目录

   • 在 VSCode 设置中搜索 vscode-cnb

   • 找到“存放markdown博文的文件夹”配置项

   • 设置为你刚才打开的工作空间路径，比如 D:\Cnblogs

二、建立合理的文件夹结构（推荐）

在 D:\Cnblogs 文件夹中，可以根据你写作内容的分类或主题建立子文件夹，例如：

makefile

复制

D:\Cnblogs\ ├─ java-learning\ ├─ life-essays\ ├─ tech-notes\ └─ travel-blogs\

• 每个子文件夹存放对应主题的 Markdown 随笔文件

• 这样分类清晰，查找编辑方便

三、随笔文件命名规范

• 文件名不一定要和博客园网页的文章标题完全相同，但建议尽量保持一致或相似，便于管理。

• 文件名建议用英文、拼音或数字，避免特殊字符和空格。

• 示例：java-learning-01.md、travel-beijing.md、life-essay-202306.md

四、关联博客园随笔与本地文件

1. 在博客园网页发布一篇新随笔后，打开 VSCode 博客园插件的随笔列表

2. 点击对应文章，插件会自动将博客内容下载到你的工作空间目录，并建立本地文件关联

3. 你可以在本地编辑该 Markdown 文件

4. 完成编辑后执行“上传到博客园”命令，同步更新博客内容

五、注意事项

• 工作空间目录应避免放在系统盘（C盘），防止空间不足

• 关联时插件通过唯一ID识别，不依赖文件名，改文件名不会影响关联

• 养成良好文件命名习惯，避免使用中文或特殊符号，方便跨平台使用和备份

• 可以根据分类建立子文件夹管理，方便批量操作和查找

• 使用插件的“自动提取图片”功能上传本地图片，保证博客图片正常显示