首页
/ Mark 14.0.0 版本发布:配置系统优化与关键修复

Mark 14.0.0 版本发布:配置系统优化与关键修复

2025-07-05 01:30:40作者:翟萌耘Ralph

Mark 是一个功能强大的命令行工具,主要用于将 Markdown 文档转换为 Confluence 格式并发布到 Confluence 知识库中。它简化了技术文档的编写和发布流程,特别适合开发团队和技术文档工程师使用。

重大变更说明

本次 14.0.0 版本带来了两个重要的破坏性变更,需要用户特别注意:

  1. 配置文件路径变更
    默认配置文件位置从 ~/.config/mark 更改为 ~/.config/mark.toml。这一变更是为了明确配置文件的格式(TOML),并与其他现代命令行工具保持一致性。用户需要将现有配置文件迁移到新位置或重新生成配置。

  2. 参数命名规范化
    移除了所有带有下划线(_)的参数和配置键,统一使用连字符(-)版本。例如,原先的 api_key 现在应改为 api-key。这一变更遵循了命令行工具参数命名的通用最佳实践,提高了工具的一致性。

核心功能改进

  1. 配置加载修复
    修复了配置文件加载逻辑中的问题,现在能够更可靠地从指定位置加载配置。这一改进减少了因配置加载失败导致的运行时错误。

  2. Confluence Cloud 路径处理优化
    针对使用 Confluence Cloud(带前缀)的情况,修复了 /wiki 路径被意外移除的问题。现在路径处理更加稳定,特别是在企业级部署环境中表现更佳。

构建与依赖更新

  1. Go 语言版本升级
    基础构建环境从 Go 1.24.3 升级到 1.24.4,带来了语言层面的性能优化和安全性改进。

  2. 工具链更新
    golang.org/x/tools 依赖从 0.33.0 升级到 0.34.0,提升了开发工具链的稳定性和功能。

升级建议

对于现有用户,升级到 14.0.0 版本时需要注意:

  1. 备份并迁移现有配置文件到新路径
  2. 检查所有脚本和自动化流程中使用的参数名称,确保使用连字符版本
  3. 特别关注 Confluence Cloud 环境中的路径处理变化

这个版本虽然包含破坏性变更,但这些改进为工具的未来发展奠定了更坚实的基础,特别是在配置管理和参数处理方面。建议所有用户尽快规划升级,以获得更稳定和一致的体验。

登录后查看全文
热门项目推荐
相关项目推荐