一个功能强大的 Markdown 文档管理工具集,支持文档预览、全文检索、图片上传等功能。
- 预览 Markdown 文件
- 支持全文检索功能
- 从 HTML 中解析表格并转换为 Markdown 格式
自动处理 Markdown 文件中的图片路径,支持将本地图片或网络图片上传到阿里云 OSS。
功能特点:
- 自动解析 Markdown 文件中的图片路径
- 支持本地图片和网络图片的上传
- 自动替换 Markdown 文件中的图片路径为 OSS URL
- 支持下载网络图片到本地临时目录
- 自动清理上传后的本地图片文件
使用方法:
python mdupload.py <markdown_file>支持将 Markdown 文件上传到飞书平台,支持协作模式和本地模式。
- Python 3.x
- 依赖库见
requirements.txt
-
克隆项目到本地:
git clone <repository-url> cd MarkdownManager
-
安装依赖:
pip install -r requirements.txt
-
复制配置模板文件:
cp resources/config.ini.example resources/config.ini
-
编辑
resources/config.ini文件,填入你的配置信息:[default] LOCAL_STORAGE = D:/Data/Markdown STRATEGY = local [oss] ACCESS_KEY_ID = your_access_key_id_here ACCESS_KEY_SECRET = your_access_key_secret_here ENDPOINT = https://oss-cn-beijing.aliyuncs.com BUCKET_NAME = your_bucket_name_here
重要提醒:
resources/config.ini文件已被添加到.gitignore中,不会被提交到版本控制系统- 请勿在代码中硬编码敏感信息(如 ACCESS_KEY_ID 和 ACCESS_KEY_SECRET)
- 建议定期更换访问密钥以确保安全性
- 确保 OSS 配置正确并有上传权限
- 图片上传工具会清理本地临时图片文件,请在执行前备份重要文件
- 脚本会直接修改传入的 Markdown 文件,建议提前备份
本项目基于 MIT 许可证发布。
感谢使用 Markdown 文档管理工具!如有问题,请提交 issue 或联系开发者。