SvelteVite作品集博客启动器

sveltekit-mdsvex-blog-template — Svelte 作品集模板

作者 loke-dev

基于 SvelteKit 与 MDsveX 的 Markdown 博客模板，使用 Tailwind CSS 排版，内置标签、暗色模式、SEO 元信息与 Cloudflare Workers 部署配置。

打开源站下载源码 ZIP

看看你的网站会是什么样

浏览真实页面截图，比较内容排版与手机效果。点击下方缩略图切换，放大查看整页细节。

3 个预览视图

桌面端首页1 / 3

访问演示网站在新标签页打开

桌面端截图首屏预览

由服务器浏览器实际访问页面后截取。

全部页面与视图 3

截图用于了解视觉与布局，交互效果请以实际项目为准。

采集于 2026-10-01查看来源

值得关注的模板亮点

从已有项目资料中，快速了解它的特点。

文章使用 .svx 文件，Markdown 正文中可直接嵌入 Svelte 组件

Tailwind CSS 配合 Typography 插件处理文章正文排版

内置标签分类、亮色/暗色主题切换

包含 SEO 相关配置：元标签、结构化数据、站点地图与社交预览

附带 Cloudflare Workers 适配器与 Wrangler 部署配置

配置了 Vitest 单元测试与 Playwright 端到端测试脚本

模板详细介绍

这是一个面向博客与作品集场景的 SvelteKit 启动模板。文章以 .svx 文件形式存放在 src/posts/ 目录，文件头用 frontmatter 声明 title、description、date、published、tag 等字段，正文为 Markdown，同时可以在文章里直接使用 Svelte 组件。样式层使用 Tailwind CSS 及其 Typography 插件处理正文排版，并提供亮色与暗色两套主题。模板附带标签分类、SEO 相关配置（元标签、结构化数据、站点地图、社交预览）以及 Cloudflare Workers 的适配器与 Wrangler 配置，测试方面配置了 Vitest 与 Playwright。

使用前需要留意几点：README 要求 Node.js 22.12+ 与 pnpm 11.17.0；仓库未提供依赖清单核对，因此不列出具体框架版本。README 中关于“快速”的描述属于模板自述，不代表实际性能表现。模板的定制入口集中在 src/variables.ts（站点信息）、src/routes/+layout.svelte（布局）与 src/routes/+page.svelte（首页）三处。演示站点中的图片、字体、图标等第三方素材需单独核对其许可，代码本身的 MIT 许可不覆盖这些内容。

SvelteVite作品集博客启动器

适合你的项目吗？

适用场景

用 Markdown 撰写并发布个人技术博客
搭建带文章列表与标签页的作品集站点
在文章正文中嵌入交互式 Svelte 组件做演示
部署到 Cloudflare Workers 的静态站点项目

适合人群

熟悉 SvelteKit 与 Markdown 写作流程的开发者
希望文章内容与 Svelte 组件混排的博客作者
需要标签分类和暗色模式的开源项目文档或作品集站点
计划使用 Cloudflare Workers 托管静态站点的团队

上手与定制指南

结合仓库当前版本的说明，按下面的资料检查内容、配置与运行要求。

1
克隆仓库后执行 pnpm install 与 pnpm dev，本地默认访问 http://localhost:5173
2
环境要求 Node.js 22.12+ 与 pnpm 11.17.0
3
在 src/posts/ 下新建 .svx 文件撰写文章，frontmatter 需包含 title、description、date、published、tag
4
站点信息在 src/variables.ts 修改，布局与首页分别在 src/routes/+layout.svelte 和 src/routes/+page.svelte
5
部署前可用 pnpm deploy:dry 预演，再执行 pnpm deploy 发布到 Cloudflare Workers

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

本次收录的是公开仓库中采用 MIT 许可的免费版本；免费范围为该版本代码，不代表外部服务或第三方素材免费。

使用时需要遵守

允许免费使用、修改、商用和分发该版本代码。
分发代码副本或实质性部分时，保留原作者版权声明和完整 MIT 许可声明。
代码按现状提供；担保与责任限制以原许可证及适用法律为准。

额外费用与待核对事项

运行环境要求：需 Node.js 22.12 及以上版本，并使用 pnpm 11.17.0 进行依赖安装与开发。
部署依赖外部服务：模板自带 Cloudflare 适配器与 Wrangler 配置，发布到 Cloudflare Workers 需使用 Cloudflare 账号及相关服务。
演示图片、字体、图标及其他第三方素材需按各自许可核对，不能仅凭代码的 MIT 许可判断。
域名、托管、数据库、支付或 AI 等外部服务可能另外收费。

查看原文依据

Permission is hereby granted, free of charge
许可证原文

Requires Node.js 22.12+ and pnpm 11.17.0.
README 原文

The included Cloudflare adapter and Wrangler configuration deploy directly to Cloudflare Workers:
README 原文

https://github.com/loke-dev/sveltekit-mdsvex-blog-template/blob/master/LICENSE https://github.com/loke-dev/sveltekit-mdsvex-blog-template/blob/master/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料，依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台: GitHub
资料与维护参考分: 资料较完整 · 92 / 100
技术栈: Svelte · Vite
网站类型: 作品集 · 博客 · 启动器

这个分数如何计算

本站按许可资料（最高30分）、演示链接（12分）、预览图（10分）、Star数（15分）、记录的维护时间（15分）、描述完整度（8分）、功能记录（5分）和分类资料（5分）计算。它不是代码、安全或性能测试，也不是 Google 评分；有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间: 2026-08-10
截图检查日期: 2026-10-01

已收录演示链接。请用你的内容与屏幕尺寸检查；有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Svelte。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料，不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

已完成服务器许可规则与 AI 来源核对；未经过人工编辑审核。

查看当时使用的来源资料

SHA-256: 9081ff3e4f063f1842881da73516f6d707031a6d14fff1c7c49d403145b5d1ea

2026-10-01T00:39:33.586Z

来源文件 / 仓库

# SvelteKit MDsveX Blog Template

A blog template built with SvelteKit, MDsveX, and Tailwind CSS. Write posts in Markdown with full Svelte component support.

![SvelteKit MDsveX Blog Template](https://github.com/user-attachments/assets/88d8ac01-220c-4c25-a3bd-27bc1ae8825a)

## Features

- **Fast** — SvelteKit with SSG, quick page loads out of the box
- **MDsveX** — Markdown posts with Svelte components
- **Tailwind CSS** — Typography plugin for clean post styling
- **SEO Optimised** — Meta tags, structured data, sitemap, social previews
- **Tags** — Tag-based post categorisation
- **Dark Mode** — Light and dark themes
- **Deployment** — Cloudflare Workers configuration included
- **Testing** — Vitest and Playwright configured

## Stack

- [SvelteKit](https://kit.svelte.dev)
- [MDsveX](https://mdsvex.pngwn.io)
- [Tailwind CSS](https://tailwindcss.com)
- [TypeScript](https://typescriptlang.org)
- [Vitest](https://vitest.dev)
- [Playwright](https://playwright.dev)

## Get Started

```bash
git clone https://github.com/loke-dev/sveltekit-mdsvex-blog-template my-blog
cd my-blog
pnpm install
pnpm dev
```

Visit `http://localhost:5173` to see your site.

Requires Node.js 22.12+ and pnpm 11.17.0.

## Writing Posts

Create `.svx` files in `src/posts/`:

```markdown
---
title: Your Post Title
description: A brief description of your post
date: 2023-06-15
published: true
tag: svelte
---

Your content here...
```

## Customise

1. Update `src/variables.ts` with your information
2. Customise the layout in `src/routes/+layout.svelte`
3. Modify the homepage in `src/routes/+page.svelte`

## Testing

```bash
pnpm test           # Unit tests
pnpm test:e2e       # End-to-end tests
pnpm test:coverage  # Coverage report
pnpm ci-check       # Complete local quality gate
```

## Deploy

[Live demo](https://sveltekit-mdsvex-blog.loke.dev)

The included Cloudflare adapter and Wrangler configuration deploy directly to
Cloudflare Workers:

```bash
pnpm deploy:dry
pnpm deploy
```

TypeScript 6 is intentional: it is the newest release currently supported by
typescript-eslint.

## License

MIT

反馈内容错误