MDX 写作,可在 Markdown 中嵌入自定义 React 组件
blog-template (The-AI-Summer) — Gatsby 博客模板
作者 The-AI-Summer
基于 theaisummer.com 精简而来的 Gatsby 科学博客模板,支持 LaTeX、代码高亮、引用与 MDX 自定义组件。
看看你的网站会是什么样
浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。
全部页面与视图 3
截图用于了解视觉与布局,交互效果请以实际项目为准。
值得关注的模板亮点
从已有项目资料中,快速了解它的特点。
Katex 与 remark-math 渲染 LaTeX 公式,prism-react-renderer 高亮代码块
内置参考文献与引用、目录、相似文章、GIF 与视频嵌入等科学写作组件
支持按主题筛选文章、自定义作者页,以及基于 flexsearch 的本地索引搜索
包含 SEO、响应式图片与图片预处理、robots.txt、XML feed 和 sitemap 生成
使用 TypeScript 与 TSX 编写,Sass 负责样式,内容可通过 GraphQL 或 YAML 获取
模板详细介绍
这是一个面向科学类博客的 Gatsby 模板,由 AI Summer 团队从自家网站 theaisummer.com 中剥离非必要部分整理而成。内容以 MDX 编写,因此可以在 Markdown 中嵌入自定义 React 组件,用于交互式图表或小工具;同时支持用标准 React 代码创建页面。
模板覆盖科学写作常见需求:LaTeX 公式通过 Katex 与 remark-math 渲染,代码块使用 prism-react-renderer 高亮,并提供参考文献与引用、GIF 与视频嵌入、目录、相似文章等组件。站点层面包含按主题筛选文章、可自定义的作者页、响应式布局、基于 flexsearch 的本地索引搜索、SEO 配置、响应式图片与图片预处理流程、Google Analytics 与 Tag Manager、robots.txt、XML feed 和 sitemap 生成。
技术栈为 Gatsby 配合 React,使用 TypeScript 与 TSX,样式采用 Sass 预处理器,内容通过 GraphQL 查询,也可从 YAML 文件读取,表单基于 react-hook-form,并支持滚动动画。需要留意的是,模板基于 Gatsby v2,上手与定制需要一定的 React 基础;README 也说明它由机器学习工程师而非前端开发者维护。
部署前需要自行更新 gatsby-config 中的站点信息、assets/images/ 下的图标、Seo.tsx 组件、styles/ 中的主题以及 site-content 下的 YAML 文件。构建后生成静态文件,public 目录可托管到任意对象存储;AI Summer 自身使用 Firebase Hosting。README 提到 Firebase 集成,启用相关动态功能前需自行配置并核对额度与收费。
适合你的项目吗?
适用场景
- 搭建以公式、代码和引用为主的技术或科研博客
- 需要把交互式 React 组件嵌入文章正文的写作场景
- 希望用 Markdown/MDX 与 YAML 管理内容、用 GraphQL 查询数据的静态站点
- 将构建产物托管到对象存储或 Firebase Hosting 的个人站点
适合人群
- 具备 React 基础、愿意按 Gatsby 方式定制模板的开发者
- 需要 LaTeX、代码高亮与引用功能的科研或技术写作团队
- 接受静态站点生成流程、自行处理部署与外部服务配置的使用者
上手与定制指南
结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。
- 1
安装依赖后运行 yarn start 启动开发环境,构建使用 yarn build,预览使用 yarn serve
- 2
部署前更新 gatsby-config 站点信息、assets/images/ 图标、Seo.tsx、styles/ 主题与 site-content 下的 YAML
- 3
构建产物位于 public 目录,可上传到任意对象存储;AI Summer 自身使用 Firebase Hosting
- 4
模板基于 Gatsby v2,定制前建议先阅读官方 Gatsby 文档
- 5
README 提及 Firebase 集成,启用前需自行配置并核对 Firebase 的额度与收费
授权与来源资料
使用条件与限制
免费使用 · 保留许可声明本次收录的是公开仓库中采用 Apache-2.0 许可的免费版本;免费范围为该版本代码,不代表外部服务或第三方素材免费。
使用时需要遵守
- 允许免费使用、修改、商用和分发;分发时需随附 Apache-2.0 许可证。
- 修改过的文件需显著标明改动,并保留相关版权、专利、商标及归属声明。
- 若原项目附有 NOTICE 文件,分发衍生作品时需保留其中适用的归属声明。
- 许可包含适用的贡献者专利授权;发起许可所述专利诉讼会终止该专利授权,且不授予商标使用权。
- 代码按现状提供;担保与责任限制以原许可证及适用法律为准。
额外费用与待核对事项
- 部署示例使用 Firebase Hosting,但 README 说明任意对象存储均可;若选用 Firebase 等外部托管服务,需自行注册账号并承担其额度与费用。
- 模板包含 Google Analytics 与 Tag Manager 集成,启用前需自行申请 Google 账号并配置相应跟踪 ID,相关服务由 Google 提供。
- README 提及 Firebase 集成;启用相关动态功能前需自行配置,并核对 Firebase 的额度与收费。
- 演示图片、字体、图标及其他第三方素材需按各自许可核对,不能仅凭代码的 Apache-2.0 许可判断。
- 域名、托管、数据库、支付或 AI 等外部服务可能另外收费。
查看原文依据
no-charge, royalty-free, irrevocable copyright license
许可证原文
For exammple, AI Summer is deployed on Firebase hosting, but any object storage will do just fine.
README 原文
https://github.com/The-AI-Summer/blog-template/blob/main/LICENSEhttps://github.com/The-AI-Summer/blog-template/blob/main/README.mdGoogle analytics and tag manager
README 原文
DeepSeek 根据仓库许可证和 README 整理 ·2026-10-01。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。
项目核对记录与介绍依据
模板资料
- 来源平台
- GitHub
- 资料与维护参考分
- 资料较完整 · 77 / 100
- 技术栈
- Gatsby · React
- 网站类型
- 博客
这个分数如何计算
本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。
这个项目需要核对什么
- 记录的仓库更新时间
- 2022-08-22
- 截图检查日期
- 2026-10-01
已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。
目录记录的主要技术栈是 Gatsby。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。
查看具体选型方法 →介绍的制作与核对状态
介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。
已完成服务器许可规则与 AI 来源核对;未经过人工编辑审核。
查看当时使用的来源资料
SHA-256: b0054910f25d2b4cee04f8bcb93adaa9a78aadd15a5d6718b26c90aea64b52d4
2026-10-01T14:02:41.592Z
来源文件 / 仓库# Scientific blog template based on AI Summer  The current template can be used for scientific blogs as it supports a wide variety of necessary components such as: - Latex rendering - Code blocks with highlighting - References and citations - Embed gifs and videos - Interactive components - Table of contents - Similar articles Other important features: - Ability to filter and display posts by topic - Customizable author pages - 100% responsive - Pages can be created with standard React code or using Markdown - Search with a local index using [flexsearch](https://github.com/nextapps-de/flexsearch) - SEO ready - Responsive images and image preprocessing pipeline - Google analytics and tag manager - robots.txt generation - XML feed generation - Sitemap generation ## See a live example in our [website](https://theaisummer.com) The template is based on [theaisummer.com](https://theaisummer.com), which we strip from all the unecessary stuff in order to provide a minimal, ready-to-use but feature-rich framework for scientific blogs.  ### Important information - The template is built with [Gatsby v2](https://www.gatsbyjs.com/) so some familiarity with React is required. For those who want to customize it, we highly recommend to check out the official [Gatsby docs](https://www.gatsbyjs.com/docs/) - Typescript and TSX is used instead of Javascript - The Sass preprocessor is used for styling - MDX is used instead of Markdown so we can add custom React components inside markdown. That enables us high customizeability, interactive widgets and more. - Latex is rendered with [Katex](https://katex.org/) and [remark-math](https://github.com/Rokt33r/remark-math) - Code blocks are rendered with [prism-react-renderer](https://github.com/FormidableLabs/prism-react-renderer) - Following Gatsby paradigm, GraphQL is used to query the website content - Content can also be sourced using YAML files - Forms can be created using [react-hook-form](https://react-hook-form.com/) - Annimations on scroll support  ### How to run the template 1) Instal the necessary dependencies ``` $ yarn install ``` 2) Run Gatsby ``` $ yarn start ``` ### What you need to do before deploying? - Update `gatsby-config` with your site information - Upload your logos and icons in `assets/images/` - Update the `Seo.tsx` component - Update your themes in `styles/` - Update the yaml files in `site-content` ### How to deploy 1) Build the final static files ``` $ yarn build ``` 2) Preview the website ``` $ yarn serve ``` 3) Transfer the `public` folder to your hosting option of choice. For exammple, AI Summer is deployed on Firebase hosting, but any object storage will do just fine. ``` $ firebase deploy ```  ## Support If you **really** like this repository and find it useful, please consider (★) **starring** it, so that it can reach a broader audience of like-minded people. It would be highly appreciated :) ! ## Contributing and Reporting Bugs You are more than welcome to contribute to the template by adding more features, fixing bugs and more. Remember that this template was created by machine learning engineers and not web developers, so our sincere apologies in advance 😂 If you find a bug, create a GitHub issue, or even better, submit a pull request. Similarly, if you have questions, simply post them as GitHub issues. More info [here](./CONTRIBUTING.md). ## Current team #### [Sergios Karagianakos](https://github.com/SergiosKar "Github page"), [Nikolas Adaloglou](https://github.com/black0017 "Github page") and [Ilias Papastatis](https://github.com/iliasprc "Github page") ## License Copyright 2022, AI Summer. Licensed under the Apache License, Version 2.0 See the [full license](./LICENSE).
看看同类模板
对比同技术栈与用途的模板,找到更适合的视觉与内容结构。

gatsby-starter-gcn
gatsby-starter-gcn 是一个面向静态网站构建的 Gatsby 启动器,将内容管理、部署和前端开发串联起来。
Gatsby · 博客

devblog
A lightweight, customizable personal blog template built with GatsbyJS and React
Gatsby · 博客

gatsby-starter-morning-dew
:rocket: A Gatsby theme/starter to build lightning-fast blog/websites
Gatsby · 博客

starter-gatsby-blog
这是一个由 Contentful 社区维护的 Gatsby 博客启动器,目标是把静态站点的低维护成本与 Contentful 的友好编辑界面结合起来。
Gatsby · 社区

clay-theme
Image-centric Gatsby theme for publishers, portfolios, photographers blogs and more.
Gatsby · 作品集

gatsby-theme-ghost
Minimalistic Gatsby theme, mobile and SEO friendly and supports author, tag and static pages.
Gatsby · 博客
