日常发布
- 点 新文章，填写标题、日期、分类、标签和正文。
- 左侧文章库可以按作者、分类和草稿状态筛选；点文章卡片即可载入编辑。
- 需要暂存时点 保存草稿；草稿不会出现在公开网站。
- 发布前先点 发布预览，确认最终渲染、路径和链接检查都没问题。
- 确认后点 发布文章 或 保存并发布。
- 发布后看左侧 部署状态，成功后公开网站会自动更新。
Blog Studio
qqqzj@Crane Admin
Checking login...
GitHub 登录
需要授权
这个后台只允许白名单里的 GitHub 用户发布文章。登录后，后端会校验身份。
Rules
评论规则
规则总览
0 条规则
敏感词命中会阻止发布；禁用用户会阻止继续评论。敏感词建议只保留你确认需要拦截的少量词条，避免误伤和卡顿。
禁用用户
敏感词
Guide
后台使用说明
编辑区
- 左边是 Markdown 源码，右边是实时渲染预览；两侧会尽量保持相同阅读位置。
- Tab 会插入真实
\t，显示宽度按 4 个空格处理，适合代码块缩进。 - 从外部复制代码时，建议先放进三反引号代码块；格式会按源码保留。
- 工具按钮可快速插入代码块、表格、公式和提示块。
- 代码块语言可写
verilog、c、cpp/c++、javascript、python、bash、json。
图片和附件
- 图片、短视频和附件用 上传并插入链接，后台会上传到公开 assets Release 并自动写入 Markdown。
- 新文章还没有正式路径时，素材会先放进草稿 Release；正式保存后引用仍然有效。
- 正文素材 会列出当前正文里已经引用的图片、视频和附件，方便发布前核对。
- 图片过大时会先在浏览器里压缩；很大的视频、图片集或资料包建议用本地迁移脚本上传 Release。
- SVG 上传会被拒绝；需要图标或矢量图时先转成 PNG / WebP。
- PDF、Markdown、文本和常见代码文件会在文章里提供预览；其他附件提供下载按钮。
分类和目录
- News 动态：网站更新、近况和公告。
- Notes 笔记：课程、复习、技术和长期整理。
- Life Log 生活记录：照片、旅行、视频和日常片段。
- 网址短名 控制公开链接；编辑旧文章时留空会保持当前链接。
- 目录 可以写成
notes/math、notes/physics、life；保存后会移动 Markdown 文件。
B 站视频
- 先把视频发布到 Bilibili。
- 复制完整视频链接或
BVxxxx号。 - 粘到 插入 B 站视频 输入框，点 插入视频块。
- 正文里会出现
@[bilibili](https://www.bilibili.com/video/BVxxxx)，发布后显示播放器。
想给备用链接加标题，可以手写 @[bilibili:钢琴练习](https://www.bilibili.com/video/BVxxxx)。
Markdown 基础语法
- 段落：空一行开始新段；段内换行会显示为换行。
- 标题：支持
# 一级、## 二级、### 三级、#### 四级，发布页会自动生成锚点和目录。 - 分隔线：单独一行写
---或更多-。 - 无序列表：每行用
- 项目或* 项目。 - 有序列表：每行用
1. 项目、2. 项目。 - 引用：每行用
> 引用内容。 - 表格：表头下一行写
| --- | --- |；单元格里的竖线用\|转义，行内代码里的竖线会保留。
行内格式
- 粗体：
**重要内容**。 - 斜体：
*强调内容*。 - 行内代码：用反引号包住，例如
`const x = 1`。 - 行内公式：可写
$E = mc^2$；像`v^2 = v_0^2 + 2ax`这样的反引号片段也会按公式显示。 - 外链：
[OpenAI](https://openai.com)。行内链接主要支持http/https。
代码和公式块
- 代码块：用上下两行三反引号包住，第一行可写语言，例如
```verilog。 - 代码块会保留空格、换行和
\t；Tab 显示宽度是 4 个空格。 - 高亮语言：
verilog、v、sv、c、h、c++、cpp、cc、cxx、hpp、javascript、js、typescript、ts、python、py、shell、bash、sh、zsh、json、html、xml、vue、css、scss、less。 - 块级公式：上下两行单独写
$$，中间放 LaTeX。
媒体和附件语法
- 图片：
，单独成段会渲染成图片卡片。 - 视频文件：
，支持mp4、webm、ogg、mov。 - 外部视频嵌入：
或 YouTube 链接。 - B 站专用块：
@[bilibili:标题](https://www.bilibili.com/video/BVxxxx)；也支持b站、哔哩哔哩标签。 - 附件下载：
[下载 PDF](https://.../file.pdf)，单独成段会渲染成附件卡片。 - 后台上传会把素材放进公开 assets 仓库的 GitHub Release，并自动插入外链；旧的
posts/media、posts/files引用仍兼容。 - 可预览附件：本地或允许嵌入的 PDF 会内嵌预览；GitHub Release PDF 按下载处理；
md、markdown、txt、css、csv、json、html、js会显示文本预览。
提示块和学术块
- GitHub 风格：
> [!NOTE]、> [!TIP]、> [!IMPORTANT]、> [!WARNING]、> [!CAUTION]。 - 数学/笔记风格：
> [!THEOREM]、> [!PROOF]、> [!EXAMPLE]、> [!DEFINITION]、> [!LEMMA]、> [!COROLLARY]。 - 围栏写法：
::: note 标题开头，正文放中间，最后单独写:::。 caution会按 warning 样式显示；没有标题时后台会自动补默认标题。
保存和恢复
- 编辑器会自动把当前内容保存到本机浏览器，刷新或误关后会尝试恢复。
- 编辑已有文章时，上传素材会先进入 assets Release，再把外链和正文保存进 source 仓库。
- owner 可以清理旧版本地草稿素材；Release 素材需要在 assets 仓库里按 Release 管理。
- 如果 GitHub 分支刚被更新，后台会提示刷新列表后再保存，避免覆盖新内容。
常见问题
- 公开网站没有马上更新：先刷新左侧部署状态，再看最近一次是否失败。
- 部署状态显示权限错误：通常是部署读取权限没有配置完整。
- 上传失败：先看文件大小；大文件建议用本地迁移脚本或 GitHub Release 手动上传。
- 文章移动目录后，公开链接会改变；已经分享出去的旧链接不会自动保留。
- 误关页面：编辑器会尝试从本机浏览器恢复最近的自动保存。
Preview
Select Post
选择一篇文章