详细发布
详细发布把发布前的每一项参数都摊开:标题、摘要、标签、分类、别名、发布时间、状态等,适合需要精细控制的场景。

入口
- 快速发布的平台卡片上点「详细发布」
- 文章管理里某篇文档的「单发」
两步流程
第一步:选择平台
按平台图标选择目标平台。已发布过的平台会标出「预览」,未发布的标「未发布」。
第二步:编辑发布内容
| 项 | 说明 |
|---|---|
| 编辑模式 | 简洁 / 详细 / 源码三种,按需要切换 |
| 文章标题 | 默认取文档标题,可修改,也可点「自动提取标题」 |
| 摘要 | 平台未返回时回退到思源笔记的摘要 |
| 标签 / 分类 | 平台支持时生效;平台未返回时回退到思源笔记 |
| 知识空间 / 专栏 / 文集 | 取决于平台;配置存值,编辑时只读 |
| 别名(slug) | 影响文章链接;文档没生成过时按本次发布结果写回 |
| 图床服务 | 按平台分别指定 |
| 图片自动上传 | 跟随设置 / 自动上传 / 不自动上传;文章设置优先于目录规则,对所有平台生效,选择后自动保存 |
| 同步修改到思源笔记 | 按钮:把当前表单内容写回文档属性(详见下一节) |
「同步修改到思源笔记」会写什么
它不发布文章,只把当前编辑页的内容写回思源文档,让下次打开这个页面时可以直接沿用:
- 思源自带属性:摘要(
memo)、标签(tags)、分类(custom-categories) - 当前平台的 YAML:按表单里的标题、摘要、标签、分类、发布时间、更新时间、别名等重新生成,连同永久链接一起写入文档的自定义属性;已发布过的文章下次打开会读回这份 YAML
- 不写正文:正文和图片始终以文档原文为准,图片仍在上传/发布时处理
几条规则:
- 直接点「发布 / 更新」时这些内容同样会写回,不必先点这个按钮
- 源码模式下以编辑框里的 YAML 为准:先点「马上保存」把 YAML 解析进模型,再同步就写回你编辑的那份
- 只在表单里改了内容、既不同步也不发布:改动只存在于当前页面,换页后丢失
源码模式与图片
源码模式显示文档的原始 Markdown(图片为本地 assets/ 路径),编辑期间不改动文档:
- 允许自动上传时,图片的上传与链接替换统一在发布时执行;关闭自动上传时保留原图片链接,远端可能无法显示本地图片
- 允许自动上传且正文包含图片时,编辑区顶部会给出提示,并可点「上传并预览替换后的内容」:立即上传图片并以替换后的结果预览,再点「恢复原文」切回;文章设置或目录规则禁止上传时,只显示「按设置不上传」,不提供上传预览入口
- 预览仅用于查看,不写入文档;保存与发布始终使用原始内容
- 预览适用于「PicGo」与平台自带图床(配置里的「当前平台」)两种方式;图床服务选「不使用」时不提示;批量分发没有单平台上下文,不提供预览
图片上传的配置步骤与优先级见控制图片自动上传。
YAML 预设配置
静态站点平台的账号配置页提供「YAML 预设配置」,用于为文章的 Front Matter(Markdown 顶部的 YAML 元数据)添加或覆盖字段。填写的是 JSON 对象,不是 YAML 文本。
2.4.0 起,预设的取值支持按当前文章自动填入:
[title]、[slug]:标题、文章别名。[tags]、[categories]:标签、分类;整个值仅包含该占位符时输出 YAML 数组,嵌在文本中时用逗号连接。[createDate]、[updateDate]:创建时间、更新时间,默认格式为YYYY-MM-DD。[createDate-YYYY-MM-DD HH:mm:ss]、[updateDate-YYYY-MM-DD]:自定义日期格式;没有更新时间时使用创建时间。格式区分大小写。
例如,为站点自动填写更新时间、标签与分类:
json
{
"updatedDate": "[updateDate-YYYY-MM-DD]",
"tags": "[tags]",
"categories": "[categories]"
}字段名需符合你的站点要求;同名字段会覆盖插件自动生成的值。占位符也可用于嵌套对象、数组中的字符串值;未知占位符保留原样。保存时会校验 JSON 格式,格式不合法时会提示修改。
这一能力适用于 Astro、Hexo、Hugo、Jekyll、VuePress、VuePress 2、VitePress、Quartz、Docsify 的 YAML 转换,以及相应的 GitLab 平台;预设留空时仍沿用各平台原有默认值。
修改预设不会重写已有文章的 YAML
预设在文章尚未保存该平台 YAML、首次生成时应用。已发布文章的更新沿用文档中已保存的 YAML;需要修改已有文章时,请在详细发布的源码模式编辑 YAML,点「马上保存」后再更新。
可以做的操作
- 发布 / 更新:首次发布用「发布」,之后用「更新」
- 强制删除:清理该平台的发布记录
- 查看文章:按「预览地址」模板打开仓库里的 Markdown 源文件;站点上的文章地址由「文章预览规则」写进 Front Matter 的
permalink(Hexo / Quartz 生效),两者不是同一个链接
合并模式的例外
批量分发使用「合并」模式时,标题与摘要的改动不生效(标签与分类会合并)。需要改标题请回到单平台发布操作。