必须初始化 Git 仓库并完成首次提交，否则无法回退修改；未执行 git init 时 git add/commit 会报 fatal 错误；首次提交前需检查文件状态、清理无关文件、验证页面本地可运行；推送远程仓库需注意分支名（main/master）和认证方式（Token 替代密码）；Git 不备份动态生成内容、CDN 资源及未保存的编辑器修改。
HTML模板项目不能靠“另存为”或手动压缩应付，必须立刻初始化 Git 仓库并完成首次提交——否则改错一行就可能回退不了。
为什么不能跳过 git init 直接 commit
Git 不会自动跟踪未初始化的目录，git add 和 git commit 在没执行 git init 的文件夹里会报错：fatal: not a git repository。这不是警告，是阻断性错误。
- 必须先在项目根目录（含
index.html、css/、js/的那一层）运行git init - 确认当前路径下生成了
.git文件夹（隐藏），否则后续所有命令都无效 - Windows 用户注意：资源管理器默认不显示隐藏文件夹，需在“查看”中勾选“隐藏的项目”
第一次提交前必须检查的三件事
刚初始化完就 git commit -m "init" 是常见失误，容易把错误结构或临时文件一起存进去。
Convert Markdown To HTML And PDF - Markdown和HTML、PDF互转
下载
实现 Markdown↔ HTML 互转，支持导出 PDF，用于用户请求的文档格式转换。
- 运行
git status，确认只列出了你真正要备份的 HTML/CSS/JS 文件和图片，没有node_modules/或编辑器自动生成的.DS_Store - 用
git add .前先删掉不需要的文件，或建一个.gitignore（内容写*.log\n.DS_Store\nThumbs.db） - 确保
index.html能本地双击打开且渲染正常——Git 备份的是文件内容，不是“看起来像网页”
远程仓库同步最容易卡在哪一步
本地 commit 成功 ≠ 安全备份。推送到 GitHub/Gitee 才算落盘，而卡点往往在认证和分支名上。
立即学习“前端免费学习笔记（深入）”；
- 执行
git remote add origin https://github.com/yourname/project.git后，务必运行git remote -v验证地址是否拼错（比如少个.git后缀） - GitHub 新建仓库默认分支是
main，但旧版 Git 初始化默认是master；若报错src refspec master does not match any，就改用git push -u origin main - 如果提示权限错误（
Authentication failed），不是密码错了，而是 GitHub 已停用密码登录——需用 Personal Access Token 替代，且 token 权限至少勾选repo
备份后仍可能丢内容的隐蔽场景
Git 提交成功，不代表所有东西都进了历史记录。最常漏掉的是浏览器里动态生成的 DOM 修改、内联样式覆盖、或 JS 注入的内容。
- 你在 Chrome 开发者工具里右键
→Copy outerHTML得到的 HTML，和 Git 里存的index.html往往不一致——前者含运行时结果，后者只是原始源码 - 如果模板依赖外部 CDN（如
https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css），Git 里不会存它，断网时页面就崩 - 用
Live Server插件预览时改的代码，没手动保存到磁盘，Git 就根本不知道有这回事
