把精力留给写作。
纸间是一个无需登录的 Markdown 编辑器。草稿和图片默认只保存在当前浏览器，直到你主动发布到 GitHub。
开始写一篇文章
- 点击左侧「＋」新建草稿，填写顶部标题，在左边写正文。右侧会实时排版。
- 不熟悉 Markdown 时，直接使用工具栏插入标题、加粗、列表、表格和代码。
- 图片可拖入正文、从剪贴板粘贴，或点「图片」选择。图片会自动压缩、命名，写入本机草稿。
- 把图片语法里的「请填写图片说明」改成具体画面说明。点击「文章设置」可选择封面、设置摘要、日期、分类和标签。
导入 Word 或旧稿
顶部「导入」支持 .md、.docx 和纸间导出的 ZIP。旧的 .doc 请先在 Word 中另存为 .docx。转换后请核对图片位置、表格和段落；艺术字、浮动排版、修订记录等不保证还原为原始版式。
导入裸 .md 不会自动找到你电脑上相邻的图片。推荐用包含 Markdown 与图片的 ZIP；每个 ZIP 导入一篇文章。
自动保存与备份
停止输入约半秒后，左上角会显示「已保存到此浏览器」。相同网址、同一浏览器重开后可继续写。换浏览器、无痕模式、清理网站数据或浏览器回收存储，都可能导致草稿不可恢复。
点「导出与备份 → 文章与图片 · ZIP」能带走完整草稿。写完重要文章后保存一份 ZIP；它可以重新导入。仅下载 .md 不包含图片。
第一次发布
- 点「发布到 GitHub」，登录你的账号。首次使用需安装纸间的 GitHub App，并选择允许访问的仓库。
- 选择仓库、目标分支和文章目录。龍一的博客已预设 main、src/content/blog 和 quality.yml。
- 其他 Astro 博客可以使用相同字段。其他框架按需填写字段映射，例如
{"pubDate":"date","description":"summary"}。请先确认网站能读取该目录中的 Markdown。 - 填好文章设置，点「发布当前文章」。图片与正文一起提交为一个版本。
- 配置了检查流程并启用自动合并时，检查通过后会自动更新网站；不满足仓库规则时会暂停，不会绕过要求。
“已提交”表示内容到了 GitHub；“已合并”表示进入目标分支；只有收到正式环境成功部署的回报，才显示“已上线”。
修改已发表文章
在发布窗口点「读取已有文章」，选择后点「打开文章」。内容和图片会保存为本机草稿。编辑后重新发布；如果有人同时在 GitHub 修改原文，会先提示冲突。原文章的网址不会自动改动。
发布失败怎么办
- 图片缺失：用 ZIP 导入完整稿件，或者重新插入缺失图片。
- 登录过期：重新登录。草稿不会丢失。
- 检查失败：打开 GitHub 发布记录，查看检查日志，修改后再发布。
- 目标分支更新：重新发起发布以基于最新版本检查；文章本身被改过则先重新读取，合并两边的内容。
- 浏览器保存失败：立即下载 ZIP 备份，再处理存储空间或重新打开页面。