Bear Blog 使用技巧

在Bear Blog上创建、编辑和管理文章

——一个极简、快速的博客平台。

认证

browser action:navigate url:https://bearblog.dev/accounts/login/

Bear Blog 需要基于浏览器的认证。通过浏览器工具登录一次后，Cookie 将持续有效。

创建文章

browser action:navigate url:https://bearblog.dev/<subdomain>/dashboard/posts/new/

步骤 1：导航到文章编辑器

步骤 2：填写编辑器Bear Blog 使用纯文本标题格式

。

• 编辑器字段包括：div#header_content
• （可编辑内容域）：属性（每行一个）textarea#body_content

：Markdown 正文已验证：使用填充/输入发布（或保存为草稿）。无需评估。

标题格式：

title: Your Post Title
link: custom-slug
published_date: 2026-01-05 14:00
tags: tag1, tag2, tag3
make_discoverable: true
is_page: false
class_name: custom-css-class
meta_description: SEO description for the post
meta_image: https://example.com/image.jpg
lang: en
canonical_url: https://original-source.com/post
alias: alternative-url

正文格式：标准 Markdown 及扩展（见下文）。

分隔符___（三个下划线）在模板中用于分隔标题和正文。

步骤 3：发布

点击发布按钮或提交表单时设置publish: true。

文章属性参考

扩展Markdown

Bear Blog 使用Mistune及其插件：

文本格式化

• ~~删除线~~→删除线
• ^上标^→ 上标
• ~下标~→ 下标
• ==高亮==→ 高亮（标记）
• **粗体**和*斜体*— 标准

脚注

Here's a sentence with a footnote.[^1]

[^1]: This is the footnote content.

任务列表

- [x] Completed task
- [ ] Incomplete task

表格

| Header 1 | Header 2 |
|----------|----------|
| Cell 1   | Cell 2   |

代码块

```python
def hello():
    print("Hello, world!")
```

通过 Pygments 实现的语法高亮（在 ``` 后指定语言）。

数学公式（LaTeX）

• 行内公式：$E = mc^2$
• 块级公式：$$\int_0^\infty e^{-x^2} dx$$

缩写

*[HTML]: Hypertext Markup Language
The HTML specification is maintained by the W3C.

警示框

.. note::
   This is a note admonition.

.. warning::
   This is a warning.

目录

.. toc::

动态变量

在您的内容中使用{{ 变量 }}：

博客变量

• {{ blog_title }}— 博客标题
• {{ blog_description }}— 博客元描述
• {{ blog_created_date }}— 博客创建日期
• {{ blog_last_modified }}— 自上次修改以来的时间
• {{ blog_last_posted }}— 自上次发布以来的时间
• {{ blog_link }}— 完整博客网址
• {{ tags }}— 带链接的标签渲染列表

文章变量（在文章模板中）

• {{ post_title }}— 当前文章标题
• {{ post_description }}— 文章元描述
• {{ post_published_date }}— 发布日期
• {{ post_last_modified }}— 自修改以来的时间
• {{ post_link }}— 完整文章网址
• {{ next_post }}— 下一篇文章链接
• {{ previous_post }}— 上一篇文章链接

文章列表

{{ posts }}
{{ posts limit:5 }}
{{ posts tag:"tech" }}
{{ posts tag:"tech,ai" limit:10 order:asc }}
{{ posts description:True image:True content:True }}

参数：

• 标签：— 按标签过滤，用逗号分隔
• 限制：— 最大帖子数
• 排序：—升序或降序(默认：降序)
• 描述：真— 显示元描述
• 图片：真— 显示元图片
• 内容：真— 显示完整内容（仅在页面上）

邮件订阅（仅限升级版博客）

{{ email-signup }}
{{ email_signup }}

链接

标准链接

[Link text](https://example.com)
[Link with title](https://example.com "Title text")

在新标签页中打开

URL前缀标签：：

[External link](tab:https://example.com)

标题锚点

标题自动获得slug化的ID：

## My Section Title

链接到：#my-section-title

排版

自动替换：

• (c)→ ©
• (C)→ ©
• (r)→ ®
• (R)→ ®
• (tm)→ ™
• (TM)→ ™
• (p)→ ℗
• (P)→ ℗
• +-→ ±

原始 HTML

Markdown 直接支持 HTML：

<div class="custom-class" style="text-align: center;">
  <p>Centered content with custom styling</p>
</div>

注意： <script>、<object><embed><form>对于免费账户，<embed>和<form>标签会被移除。内嵌框架（Iframe）有白名单机制（如YouTube、Vimeo、Spotify等）。允许的内嵌框架来源youtube.com, youtube-nocookie.com

vimeo.com

• soundcloud.com
• spotify.com
• codepen.io
• google.com（文档、云端硬盘、地图）
• bandcamp.com
• apple.com（音乐嵌入）
• archive.org
• 以及其他...
• 仪表板网址
• 请将

<subdomain>

替换为你的博客子域名：博客列表：https://bearblog.dev/dashboard/

• 仪表板： https://bearblog.dev/<subdomain>/dashboard/
• Dashboard: https://bearblog.dev/<subdomain>/dashboard/
• 文章列表： https://bearblog.dev/<subdomain>/dashboard/posts/
• 新建文章： https://bearblog.dev/<subdomain>/dashboard/posts/new/
• 编辑文章： https://bearblog.dev/<subdomain>/dashboard/posts/<uid>/
• 样式设置： https://bearblog.dev/<subdomain>/dashboard/styles/
• 导航设置： https://bearblog.dev/<subdomain>/dashboard/nav/
• 数据分析： https://bearblog.dev/<subdomain>/dashboard/analytics/
• 设置： https://bearblog.dev/<subdomain>/dashboard/settings/

示例：完整文章

标题内容：

title: Getting Started with AI Assistants
link: ai-assistants-intro
published_date: 2026-01-05 15:00
meta_description: A beginner's guide to working with AI assistants
tags: ai, tutorial, tech
is_page: false
lang: en

正文内容：

AI assistants are changing how we work. Here's what you need to know.

## Why AI Assistants?

They help with:
- [x] Writing and editing
- [x] Research and analysis
- [ ] Making coffee (not yet!)

> "The best tool is the one you actually use." — Someone wise

## Getting Started

Check out [OpenAI](tab:https://openai.com) or [Anthropic](tab:https://anthropic.com) for popular options.

---

*What's your experience with AI? Let me know!*

{{ previous_post }} {{ next_post }}

提示

1. 发布前预览—— 使用预览按钮检查格式
2. 使用模板— 在仪表板设置中创建文章模板以确保标题一致性
3. 定时发布文章— 设置发布日期为未来时间
4. 草稿模式— 不要点击发布按钮以保持为草稿
5. 自定义CSS— 在博客CSS中添加类名和样式
6. SEO优化— 务必设置元描述和元图像

故障排除

• 文章未显示？检查发布状态和发布日期
• 标签无效？使用逗号分隔，无需引号
• 样式问题？检查类名已转换为slug格式（小写，连字符）
• 日期格式错误？使用YYYY-MM-DD HH:MM