Markwrite 墨页
← 操作指南

用 Git 管理 Markdown:审阅改动、选择提交与解决冲突

README、项目方案和实验记录可以与代码一起迭代。Markwrite 把磁盘改动审阅和本地 Git 提交放进阅读编辑窗口,让每次文档修改都有可检查的记录。

基于 Markwrite v1.2.1;截图来自真实应用。

打开现有项目文件夹

已有仓库保留在原处。初始化会在所选文件夹中添加 Git 元数据,不需要把文档导入另一个知识库。

  1. 确认电脑已安装 Git,并已为提交配置 Git 作者身份。
  2. 选择「文件 → 打开文件夹」,打开项目目录,再进入「工具 → Git 版本管理」。
  3. 查看当前分支和文件状态。如果目录还不是仓库,并且你希望开始记录它,点击「在当前文件夹初始化 Git」。
Markwrite 显示 Git 当前分支、修改文件、文字差异与本地提交控件
创建本地提交前,先查看分支、文件状态与具体修改。

检查已保存的修改,只提交选中的文件

普通提交只包含明确选中的文件。将无关修改留在本次选择之外,可以让每次提交的目的更容易理解。

  1. 先保存希望纳入 Git 的文档修改。Git 记录磁盘文件,编辑器里尚未保存的文字不会自动成为提交。
  2. 点击 Git 面板中的文件查看差异;如果同时存在工作区更改与已暂存更改,两部分都应审阅。
  3. 勾选属于本次修改的文件,并填写清楚的提交说明,例如「补充安装步骤」。
  4. 点击「提交选中的」文件按钮。成功后,Markwrite 会显示新建的本地提交编号。

通过三方比较处理合并冲突

合并提交包含全部已暂存文件,完成前要检查完整范围。「标记已解决」会暂存磁盘上的当前内容,因此应先保存正确的结果。

  1. 仓库出现冲突文件时,点击旁边的「三方比较…」,查看共同基线、本地版本与传入版本。
  2. 逐块选择「保留本地」「保留传入」或「保留双方」;冲突块包含基线数据时,还可「保留基线」。最终内容也可以手动修改。
  3. 点击「保存解决结果」,检查保存后的内容,再在 Git 面板点击「标记已解决」。
  4. 全部冲突解决后,点击「选择全部已暂存文件」,填写说明并「完成合并提交」。

本地历史与远程同步的边界

内置流程创建本地提交,不会自动推送到 GitHub 或其他远程仓库。获取、拉取和推送继续使用你熟悉的 Git 工具。

解决冲突时,如果预期的磁盘或索引版本已变化,应用会拒绝覆盖。打开的文档仍有未保存修改或磁盘冲突时,应先处理再保存合并结果。

过大的 Git 差异可能超出应用预览限制,需要使用系统 Git 工具;二进制文件没有文字预览。Git 历史也不能代替独立备份。