文章以 contents 目录下的 Markdown 文件形式管理
svelte-markdown-blog-template — Svelte 博客模板
作者 kan1-u
一个用 Svelte 构建的 Markdown 博客模板,文章以 Markdown 文件形式存放在 contents 目录,附带 GitHub Pages 部署工作流。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
每篇 Markdown 需在开头提供 title、author、date、description 元数据
svelte.config.js 中需将 kit.paths.base 设为仓库名称以匹配部署路径
仓库自带 GitHub Actions 工作流,构建产物发布到 gh-pages 分支
本地开发与构建命令分别为 npm run dev 和 npm run build
采用 MIT 许可,允许免费使用、修改、商用和分发
模板详细介绍
这是一个基于 Svelte 的博客模板,内容以 Markdown 文件驱动。仓库的 contents 目录中的 Markdown 文件会被识别为文章,初始包含一个 sample.md 示例文件,删除后即可创建自己的文章。每篇 Markdown 文件开头必须提供元数据,包含 title、author、date 和 description 字段。
模板的部署路径需要手动配置:在 svelte.config.js 中把 kit.paths.base 设置为仓库名称,README 给出的示例值为 /svelte-markdown-blog-template。仓库自带一个 GitHub Actions 工作流,在推送到 main 分支时执行安装、构建,并通过 peaceiris/actions-gh-pages 将 build 目录发布到 gh-pages 分支,因此可以借助 GitHub Pages 发布站点。
本地开发使用 npm run dev,构建使用 npm run build。仓库采用 MIT 许可,可免费使用、修改、商用和分发该版本代码,但演示图片、字体、图标等第三方素材需单独核对其许可,域名、托管等外部服务也可能产生费用。模板未提供关于样式、分类、标签、分页或评论等功能的说明,使用前需自行确认。
适合你的项目吗?
适用场景
- 需要一个以 Markdown 文件写文章的个人博客站点
- 希望借助 GitHub Pages 免费托管静态博客
- 想以 Svelte 项目为基础自行扩展博客功能
适合人群
- 熟悉 Markdown 写作、希望内容与代码分离的写作者
- 使用 GitHub 仓库管理并发布静态站点的开发者
- 愿意手动修改配置文件与部署路径的使用者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
将 svelte.config.js 中 kit.paths.base 改为自己的仓库名称
- 2
在 contents 目录新增 Markdown 文件作为文章,可删除示例 sample.md
- 3
每篇 Markdown 开头必须写入 title、author、date、description 元数据
- 4
推送到 main 分支后由自带工作流构建并发布到 gh-pages 分支
- 5
本地预览使用 npm run dev,构建使用 npm run build
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 MIT 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发该版本代码。
- 分发代码副本或实质性部分时,保留原作者版权声明和完整 MIT 许可声明。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 使用前必须手动修改 svelte.config.js 中的 kit.paths.base,将其设置为实际部署的仓库名称,否则站点资源路径会出错。
- 每篇 Markdown 文章开头必须提供 title、author、date、description 元数据,缺少元数据将无法正常生成文章。
- 发布依赖 GitHub Pages 服务,需要 GitHub 账号与仓库,并可能受该外部服务的条款与费用约束。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 MIT 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
Permission is hereby granted, free of charge
许可证原文
Set the `base` property in `svelte.config.js` to the repository name.
README 原文
Metadata is always required at the beginning of the markdown file.
README 原文
https://github.com/kan1-u/svelte-markdown-blog-template/blob/main/LICENSEhttps://github.com/kan1-u/svelte-markdown-blog-template/blob/main/README.mdYou can easily publish using [Github Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages).
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料一般 · 65 / 100
- 技术栈
- Svelte
- 网站类型
- 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2022-07-03
- 截图检查日期
- 2026-10-01
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Svelte。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
已完成服务器许可规则与 AI 来源核对;未经过人工编辑审核。
查看当时使用的来源资料
SHA-256: 8f61075d8d20f69d7e68134581611c5f60f339f5eb0875a439b9ae6a21ae79b6
2026-10-01T00:29:03.989Z
来源文件 / 仓库# Svelte Markdown Blog Template
A Markdown-based blog template developed in Svelte.
## Setup
Set the `base` property in `svelte.config.js` to the repository name.
```javascript
const config = {
kit: {
paths: {
base: '/svelte-markdown-blog-template' // Change to the your repository name.
}
}
};
```
## Write Post
The markdown files in `contents` are recognized as posts.
This repository has `sample.md` at the initially.
You can delete it to create your own posts.
Metadata is always required at the beginning of the markdown file.
```markdown
---
title: Sample Post
author: Uegaki
date: 2022-07-03
description: A sample post introducing some of the features. 😀
---
```
## Publish
You can easily publish using [Github Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages).
This repository has a Github Workflow for that, just publish the `gh-pages` branch.
```yaml
name: github pages
on:
push:
branches:
- main
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: 16
cache: 'npm'
- name: Install
run: npm i
- name: Build
run: npm run build
- name: Deploy
uses: peaceiris/actions-gh-pages@v3
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
publish_dir: ./build
```
## Development
You can free to develop in any environment you like.
```shell
npm run dev
```
- build
```shell
npm run build
```
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

CMSaasStarter
A modern SaaS template/boilerplate built with SvelteKit, Tailwind, and Supabase. Includes marketing page, blog…
Svelte · 后台

sveltepress
Sveltepress 是一个建立在 SvelteKit 之上的文档与博客静态站点生成工具,思路接近 VitePress,但保留了完整的 SvelteKit 能力面(SSR、适配器、服务端路由、hooks)。
Svelte · 工具站

sveltekit-blog-template
A SvelteKit blog template
Svelte · 博客

sveltekit-mdsvex-blog
A minimalistic blog template built with SvelteKit and MDsveX
Svelte · 博客

tablog-svelte
Tablog reimagined in Svelte/SvelteKit, a lightweight blogging setup powered entirely by Markdown.
Svelte · 博客

sveltekit-mdsvex-blog-template
MDsveX blog starter template built with Sveltekit & Tailwind
Svelte · 作品集
