写博客
写博客
公开博客在 yangjunx21.github.io/blog/。在 写文章 页面中直接排版和预览；草稿自动保存在当前浏览器。
写一篇文章
- 在写作页填写标题和正文，摘要、标签可选。顶部工具栏可以设置标题、加粗、代码、链接、列表、引用、代码块和分隔线；二三级标题会生成文章目录。右侧“发布前检查”会提示还缺什么。
- 也可以直接用 Markdown 的习惯输入：行首输入
##、###、-、1.、>后按空格；输入```或---后回车；行内输入`代码`或**加粗**。快捷键：⌘K 链接，⌘S 立即保存，⌘↵ 发布（Windows 用 Ctrl）。 - 粘贴 Markdown、网页或文档内容时会自动转成对应排版；截图可粘贴或拖入正文。点击图片可以上移、下移或删除，图片下方可以填写说明文字，发布后显示为图注。
- 点击“发布”，按弹窗中的步骤操作：打开已预填标题、摘要、标签和正文的 GitHub 表单；文章较长时先复制正文再粘贴；有本地图片时，在写作页按顺序复制每张图片，逐张粘贴到 GitHub 表单的“图片上传区”，等上传链接出现。最后勾选“同步到个人博客”并提交。GitHub Actions 会把图片和图注放回正文相应位置，生成
_posts/中的文章，并请求 GitHub Pages 更新网站。 - 之后直接编辑这条 Issue，就能更新文章。取消勾选“同步到个人博客”后，文章会从博客撤下。
支持的写法（和 Typora / GitHub 一致）
写作页、GitHub Issue 正文和博客页面都支持下面这些写法；写作页里会直接显示效果。
| 内容 | 写法 | 写作页 |
|---|---|---|
| 行内公式 |
$E = mc^2$，也可以写 \(...\)
|
输入结尾的 $ 后立即渲染，点击公式可修改 |
| 公式块 | 单独一行 $$，或 \[...\]、```math
|
输入 $$ 回车，或点工具栏“∑ 公式” |
| 表格 |
\| 列1 \| 列2 \| 加 \| --- \| :---: \|
|
输入 \| 列1 \| 列2 \| 回车；Tab 换格，回车到下一行，空行回车离开表格 |
| 任务列表 |
- [ ] 待办、- [x] 完成
|
行首输入 [ ] 加空格，点击方框勾选 |
| 代码块 | ```python |
输入 ```语言 回车，右上角可改语言 |
| 流程图 | ```mermaid |
代码块下方实时预览 |
| 高亮、删除线 |
==高亮==、~~删除~~
|
输入结尾符号后生效 |
| 提示框 |
> [!NOTE]，还有 TIP、IMPORTANT、WARNING、CAUTION |
引用中第一行写标记 |
| 脚注 | 正文 [^1]，文末 [^1]: 内容
|
原样保留 |
| 表情 | :smile: |
发布后显示为表情 |
从 ChatGPT、Claude、维基百科复制带公式的内容时，公式会以 LaTeX 保留。普通文字里的 $5 不会被当成公式；如果确实要写成对的美元符号，用 \$。
文章网址使用 Issue 编号，例如 /blog/2026/09/25/post-123/，修改标题不会破坏旧链接。若同步失败，打开仓库的 Actions → Publish blog issue 查看原因。
备份草稿
写作页的草稿仅存于当前浏览器，清除站点数据或更换设备后无法找回。点“下载备份 .md”会得到一份包含标题、摘要、标签和全部图片的 Markdown 文件；把它的内容粘贴回空白的写作页即可恢复。
公开范围
这个仓库是公开的；提交的 Issue、上传的图片和已生成的文章文件都可以被他人查看。不勾选“同步到个人博客”只会阻止文章显示在个人主页，并不会把 Issue 变为私密。文章页底部的“在 GitHub 讨论”会链接到对应 Issue，读者可以在那里留言。
订阅地址：feed.xml。