Upgit 图片管理实战：为 Markdown 博客带来极致高效的图片管理体验

在博客写作的过程中，图片管理是提升效率和内容质量的关键环节。Upgit 作为高效、跨平台的文件上传工具，可以帮助博客创作者将图片便捷地上传至 GitHub，并生成可直接引用的外链，特别适合以 Markdown 写作为核心的写作流程。

Upgit 是一款开源的文件上传工具，项目地址：https://github.com/pluveto/upgit。它能将图片、文档等文件快速上传到 GitHub、Gitee、CDN 以及各类网盘，自动生成直链，特别适合 Markdown 写作、博客创作和团队协作等场景。[1]

核心功能与特点

跨平台无侵扰：支持 Linux、macOS、Windows，且轻量不常驻内存
多目标上传：支持 GitHub、Gitee、七牛云、SMMS、Imgur 等主流平台，灵活满足个人及团队不同需求
剪贴板直传：可直接从剪贴板上传文件，并自定义重命名上传规则和路径
编辑器集成：与 Typora、VS Code、Obsidian 等常用编辑器无缝集成
自动生成直链：支持自动生成文件直链，方便在 Markdown 或博客中引用

为什么选择 Upgit 管理博客图片

传统的图片管理方式往往存在文件散乱、手工上传繁琐、外链不透明等痛点。Upgit 将这些问题转化为现代化的解决方案：

统一管理：所有图片统一存储在 GitHub 仓库中，便于版本控制和团队协作
自动归档：通过自定义命名规则，可按时间、项目等维度自动归档
直链明确：生成的图片链接清晰可见，便于管理和复用
工作流整合：与主流编辑器深度联动，实现剪贴板一键上传，极大减少手动操作

安装与基础配置

安装方式

推荐使用 Homebrew (适用于 macOS、Linux) 一行命令安装：

1
brew install upgit

配置指南

Upgit 采用 config.toml 作为核心配置文件，需提前准备 GitHub 仓库、用户名和访问令牌 (PAT)。以下是针对 GitHub 上传的完整配置示例：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 默认上传器选择 GitHub
default_uploader = "github"

# 上传文件命名模板，按年月日自动归档
# {year} 年份, 例如: 2022
# {month} 月份, 例如: 02  
# {day} 天, 例如: 01
# {unix_ts} 时间戳, 例如: 1643617626
# {fname} 原始文件名，如 logo (不含后缀名)
# {fname_hash} {fname}的 MD5 散列值
# {ext} 文件后缀名, 例如.png
rename = "hashnode/{year}/upgit_{year}{month}{day}_{fname}{ext}"

# 自定义输出格式
[output_formats]
"bbcode" = "[img]{url}[/img]"
"html" = '<img src="{url}" />'
"markdown-simple" = "![]({url})"

# GitHub 上传器配置
[uploaders.github]
# 保存文件的分支，例如 master 或 main
branch = "main"
# 您的拥有"repo"权限的 GitHub 令牌
# 获取 GitHub Token 地址: https://github.com/settings/tokens
pat = "ghp_xxx" # 填写你的实际 GitHub Token

配置要点说明：

rename 模板可将图片按年月日自动归档到不同目录，便于长期管理和溯源
output_formats 支持自定义输出格式，直接生成 Markdown 所需外链格式
GitHub Token 需要具备 “repo” 权限才能正常上传文件

网络加速优化

如遇 GitHub 国内访问受限，可配置 CDN 加速：

1
2
3
4
# 直链替换规则 RawUrl -[replace]-> Url
[replacements]
"raw.githubusercontent.com" = "cdn.jsdelivr.net/gh"
"/main" = "@main"

实际用法与创作体验

基础上传流程

命令行上传：选中文件或截图后，运行 upgit，即刻完成上传并自动将直链复制到剪贴板
编辑器集成：在 Typora、Obsidian 编辑 Markdown 时，直接粘贴即可引用图片
剪贴板直传：截图后直接运行 upgit，无需保存到本地

团队协作优势

统一仓库管理：团队成员可共用同一图片仓库，便于资源复用
版本控制友好：所有图片变更都有 Git 记录，便于追溯和管理
目录结构清晰：通过自定义命名规则，保持项目目录整洁

写作体验提升

无缝粘贴：截图 → 上传 → 获取链接，一气呵成
本地目录清爽：图片统一云端管理，本地 Markdown 文件更轻量
跨设备同步：基于云端存储，任何设备都可访问相同的图片资源

小结与推荐用法

Upgit 将传统博客图片 “散乱难查找、手工上传、外链不透明” 的痛点，转化为 “自动归档、直链明确、配置灵活、团队共用” 的现代体验，是 Markdown 博客创作者和内容团队极佳的图片管理解决方案。

推荐使用场景：

个人博客写作，需要大量图片管理
团队内容创作，需要统一的图片资源库
技术文档编写，需要截图和图例管理
跨平台写作，需要统一的图片访问方式

通过合理配置 CDN 加速、分目录存储、自定义命名等功能，Upgit 能为不同写作风格和团队习惯提供最佳的图片管理体验。

特别感谢
本文由作者与 AI 协同创作完成，内容融合了真实应用体验和前沿工具解读，希望为大家带来实用且高效的 Mac 使用参考。