Mark项目14.0.1版本发布：配置系统重大升级

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

版本核心变更

14.0.1版本主要解决了13.0.0版本中存在的版本号报告错误问题，并对配置系统进行了重大改进：

1. 配置文件格式变更：默认配置文件路径从~/.config/mark变更为~/.config/mark.toml，采用了更标准的TOML格式，提高了可读性和兼容性。

2. 命名规范统一：移除了所有带下划线的参数和配置键，统一使用连字符版本。这一变更使得命令行参数和配置文件中的键名风格保持一致，减少了用户在使用过程中的混淆。

3. Confluence Cloud兼容性增强：修复了在使用Confluence Cloud时/wiki路径被错误移除的问题，提升了与Confluence Cloud的集成稳定性。

技术细节解析

配置系统改进

新版本对配置加载机制进行了重构，解决了之前版本中存在的配置加载问题。TOML格式的引入带来了以下优势：

• 更清晰的层次结构
• 更好的注释支持
• 更严格的数据类型定义
• 更广泛的工具链支持

命名规范统一

项目团队决定统一使用连字符(hyphen)作为单词分隔符，这是基于以下考虑：

1. 命令行工具传统上更倾向于使用连字符
2. 提高了配置文件的可读性
3. 减少了不同环境下解析的歧义
4. 与主流命令行工具的命名风格保持一致

构建系统升级

项目持续保持对Go工具链的更新，本次版本构建使用了：

• Go 1.24.4
• golang.org/x/tools 0.34.0

这些更新带来了性能改进和安全修复，确保项目构建的稳定性和可靠性。

升级建议

对于现有用户，升级到14.0.1版本需要注意：

1. 如果使用了自定义配置文件，需要将文件重命名为mark.toml
2. 检查脚本和自动化工具中是否使用了带下划线的参数，需要更新为连字符版本
3. Confluence Cloud用户将获得更稳定的/wiki路径处理

总结

Mark 14.0.1版本虽然是一个修复版本，但对配置系统进行了重要改进，为未来的功能扩展打下了坚实基础。命名规范的统一也提高了项目的整体一致性，使得用户在使用过程中更加顺畅。对于技术文档工程师和开发团队来说，升级到这个版本将获得更稳定、更一致的体验。