跳过主要内容
Template logoTemplate
全部文章
通用

Markdown 示例

一篇示例文章,覆盖博客支持的全部 Markdown 元素。

这是模板自带的示例文章。它的用途有两个:让你看到博客填上真实内容后的样子,以及 验证每一种 Markdown 元素都能正确渲染。你可以改写它,也可以直接删掉 —— 文章都以 Markdown 文件的形式放在 content/blog/ 下。

标题与文本

三级标题

四级标题

正文支持粗体斜体粗斜体删除线行内代码,以及指向 站内其他页面站外站点的链接。裸链接也会 自动识别:https://developers.cloudflare.com/workers/

Cmd + K 打开命令面板。

列表

无序列表,带嵌套:

  • 账户、支付与邮件
    • 邮箱与社交登录
    • 订阅与一次性购买
  • 用于博客与更新日志的 content collections
  • 部署到 Cloudflare Workers

有序列表:

  1. 克隆模板
  2. 填写环境变量
  3. 执行数据库迁移
  4. 部署

任务列表:

  • 设置站点名称与元数据
  • 替换 logo 与 OG 图
  • 写下第一篇真正的文章
  • 把域名指向 Worker

引用

会大声报错的配置,胜过悄悄出错的配置。

—— 来自部署检查清单,代价换来的经验

代码

行内代码 pnpm dev 与代码块的观感不同:

import { createServerFn } from '@tanstack/react-start';
import { z } from 'zod';

export const greet = createServerFn({ method: 'POST' })
  .inputValidator(z.object({ name: z.string().min(1) }))
  .handler(async ({ data }) => {
    return { message: `你好,${data.name}` };
  });
pnpm install
pnpm dev

表格

功能服务商开关
数据库Cloudflare D1preset.auth
存储Cloudflare R2preset.storage
邮件Cloudflare Emailpreset.mail
支付Stripe / Creem / WaffoVITE_PAYMENT_PROVIDER

图片

示例封面图

折叠区块

文章放在哪里?

每篇文章都是 content/blog/ 下的一个 Markdown 文件,frontmatter 包含 titledescriptiondatecategoryimage。slug 由文件名派生,例如 markdown-showcase.md 对应 /blog/markdown-showcase。中文版本在扩展名前加 .zh 即可。


上面那条分割线是最后一种元素。博客渲染的全部内容都是标准的 GitHub Flavored Markdown1,能写进 README 的写法在这里同样成立。

Footnotes

  1. 由 remark 解析、rehype 渲染,见 src/lib/markdown.ts