整体目标
本地用 VS Code 编辑 Markdown 笔记,粘贴图片时自动生成相对路径,手动将笔记 + 压缩后的图片备份到腾讯云 COS。
前置准备
环境 / 账号准备
安装最新版 VS Code(官网下载);
开通腾讯云 COS 服务:
- 登录腾讯云控制台,搜索「对象存储 COS」并开通;
- 创建存储桶(建议「私有读」,地域选就近的如 ap-guangzhou,存储桶名称记下来);
- 进入「访问管理 → 密钥管理」,创建 API 密钥(SecretId/SecretKey,记下来,后续备份用)。
本地笔记目录初始化
在电脑本地新建统一的笔记根目录(如D:/Notes),后续所有笔记都放在这个目录下,目录结构示例:
plaintext
D:/Notes/
├── 学习笔记/ # 分类文件夹
│ └── Python基础.md # 笔记文件
└── 工作记录/└── 项目复盘.md
步骤 1:VS Code 配置(粘贴图片自动压缩 + 相对路径)
打开 VS Code 设置文件:快捷键 Ctrl+Shift+P → 输入「Preferences: Open User Settings (JSON)」→ 回车;
将以下配置粘贴到 settings.json 中:
{// markdown同级存放图片目录"markdown.copyFiles.destination": {"**/*": "images/${documentBaseName}/"},// 工作区固定目录(按需选取)"markdown.copyFiles.destination": {"**/*": "${documentWorkspaceFolder}/assets/"}
}
保存 settings.json,配置立即生效。
步骤 2:本地编辑笔记(粘贴图片自动压缩)
2.1 打开笔记目录
VS Code → 左上角「文件」→「打开文件夹」→ 选择本地笔记根目录(如D:/Notes)。
2.2 新建 / 编辑 Markdown 笔记
- 右键笔记目录 →「新建文件」→ 命名为XX笔记.md(如Python基础.md);
- 正常编辑文字内容,需要插入图片时:
- 截图 / 复制图片(如微信截图、本地图片);
- 在 Markdown 中光标定位到要插入图片的位置;
- 按快捷键Ctrl+V),图片会自动:
- 保存到./images/笔记名/目录(相对路径,如./images/Python基础/image.png);
2.3 本地预览验证
编辑完成后,按Ctrl+Shift+V打开 Markdown 预览;
确认图片正常显示(相对路径生效),本地图片目录和笔记文件路径对应。
步骤 3:手动备份笔记 + 图片到腾讯云 COS
3.1 选择备份工具(二选一)
方式 1:腾讯云 COS 控制台手动上传(适合新手 / 少量笔记)
登录腾讯云 COS 控制台 → 进入你的存储桶;
点击「上传文件 / 文件夹」→ 选择本地笔记根目录下的文件 / 文件夹:
笔记文件(.md)直接上传;
图片文件夹(images)整体上传(已压缩,无需额外处理);
保持云端目录结构和本地一致(如云端也创建学习笔记/images/)。
方式 2:COSCLI 命令行上传(适合批量 / 频繁备份,推荐)
安装 COSCLI:
下载地址:腾讯云 COSCLI 官网,按系统(Windows/Mac/Linux)下载并配置环境变量;
配置 COSCLI:
打开终端(CMD/PowerShell)→ 执行coscli config;
按提示输入:SecretId、SecretKey、地域(如 ap-guangzhou)、存储桶名称(默认存储桶);
执行备份命令:
终端进入本地笔记根目录(如cd D:/Notes);
执行同步命令:coscli sync ./ cos://你的存储桶名称/Notes/ --include .md --include .png --include .jpg --include .webp;
命令说明:将本地当前目录的.md 和图片文件同步到云端Notes/目录,保持路径一致。
@echo off
chcp 65001 >nul 2>&1
title 笔记备份到腾讯云COS:: ====================== 请手动修改以下配置项 ======================
set "NOTE_ROOT_DIR=D:\Notes" :: 你的本地笔记根目录(改为自己的路径)
set "COS_BUCKET_NAME=你的存储桶名称" :: 腾讯云COS存储桶名称(如notes-125xxxxxxx)
set "COS_REMOTE_DIR=Notes/" :: 云端存储目录(保持默认或自定义)
:: =================================================================:: 切换到笔记根目录
cd /d "%NOTE_ROOT_DIR%"
if errorlevel 1 (echo 错误:本地笔记目录 "%NOTE_ROOT_DIR%" 不存在!pauseexit /b 1
):: 执行COS同步命令(仅同步md和图片文件)
echo 开始同步笔记到腾讯云COS...
echo 本地目录:%NOTE_ROOT_DIR%
echo 云端目录:cos://%COS_BUCKET_NAME%/%COS_REMOTE_DIR%
echo.coscli sync ./ cos://%COS_BUCKET_NAME%/%COS_REMOTE_DIR% ^
--include *.md ^
--include *.png ^
--include *.jpg ^
--include *.jpeg ^
--include *.webp:: 执行结果判断
if errorlevel 0 (echo.echo ======================echo ✅ 备份完成!echo ======================
) else (echo.echo ======================echo ❌ 备份失败!请检查:echo 1. COSCLI是否已安装并配置echo 2. 存储桶名称是否正确echo 3. 本地目录是否存在echo ======================
)pause
3.2 备份验证
登录 COS 控制台 → 进入存储桶 → 查看「Notes」目录;
确认.md 文件和 images 文件夹已上传,图片是压缩后的版本。
注意事项
密钥安全:COS 的 SecretId/SecretKey 不要泄露,COSCLI 配置后会加密存储,无需担心;
增量备份:COSCLI 的sync命令默认只上传新增 / 修改的文件,批量备份效率高。
总结
核心流程:本地初始化目录 → VS Code 配置 → 编辑笔记 → 手动同步到 COS。全程无额外脚本,仅通过配置和 COS 官方工具实现,兼顾易用性和资源节省,符合笔记管理的核心需求。