Svelte博客

svelte-markdown-blog-template — Svelte 博客模板

作者 kan1-u

一个用 Svelte 构建的 Markdown 博客模板,文章以 Markdown 文件形式存放在 contents 目录,附带 GitHub Pages 部署工作流。

看看你的网站会是什么样

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

3 个预览视图
桌面端首页1 / 3
桌面端截图首屏预览

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

全部页面与视图 3

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

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

值得关注的模板亮点

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

01

文章以 contents 目录下的 Markdown 文件形式管理

02

每篇 Markdown 需在开头提供 title、author、date、description 元数据

03

svelte.config.js 中需将 kit.paths.base 设为仓库名称以匹配部署路径

04

仓库自带 GitHub Actions 工作流,构建产物发布到 gh-pages 分支

05

本地开发与构建命令分别为 npm run dev 和 npm run build

06

采用 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 许可,可免费使用、修改、商用和分发该版本代码,但演示图片、字体、图标等第三方素材需单独核对其许可,域名、托管等外部服务也可能产生费用。模板未提供关于样式、分类、标签、分页或评论等功能的说明,使用前需自行确认。

Svelte博客

适合你的项目吗?

适用场景

  • 需要一个以 Markdown 文件写文章的个人博客站点
  • 希望借助 GitHub Pages 免费托管静态博客
  • 想以 Svelte 项目为基础自行扩展博客功能

适合人群

  • 熟悉 Markdown 写作、希望内容与代码分离的写作者
  • 使用 GitHub 仓库管理并发布静态站点的开发者
  • 愿意手动修改配置文件与部署路径的使用者

上手与定制指南

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

  1. 1

    将 svelte.config.js 中 kit.paths.base 改为自己的仓库名称

  2. 2

    在 contents 目录新增 Markdown 文件作为文章,可删除示例 sample.md

  3. 3

    每篇 Markdown 开头必须写入 title、author、date、description 元数据

  4. 4

    推送到 main 分支后由自带工作流构建并发布到 gh-pages 分支

  5. 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 原文

You can easily publish using [Github Pages](https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages).

README 原文
https://github.com/kan1-u/svelte-markdown-blog-template/blob/main/LICENSEhttps://github.com/kan1-u/svelte-markdown-blog-template/blob/main/README.md

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
```
反馈内容错误

看看同类模板

对比同技术栈与用途的模板,找到更适合的视觉与内容结构。