这是一个测试标题

Surge 是一个基于 Markdown 和 YAML 格式的静态网站生成器，支持快速创建、构建和部署静态网站，你可以使用 Surge 来创建简洁、快速加载的网页或博客。

以下是一些基本的 Surge 教程，帮助你开始使用：

安装 Surge

你需要安装 Surge，可以通过以下命令安装（macOS 和 Windows）：

curl -fsSL https://surge.sh | sh

安装完成后,Surge 会被添加到你的 PATH 中，你可以通过在终端中运行 surge 来启动 Surge。

创建新项目

在终端中进入你想要创建项目的目录,运行以下命令：

surge new myproject

这将为你创建一个新的 Surge 项目，包含默认的 content 文件夹和一些初始内容。

Surge 使用 Markdown 格式编写内容，你可以在 content 文件夹中创建 markdown 文件，如 page.md。

--- "这是一个测试标题"
description: "这是一个测试描述"
---
这是一个测试内容，Surge 支持 Markdown 格式，包括标题、列表、链接和代码块。
### 代码块
```javascript
console.log("这是一个测试代码块");

部署到 Surge后，你可以将项目部署到 Surge 平台，运行以下命令：

surge push

这将将你的项目部署到 Surge 平台，并为你生成一个公共 URL。

使用 GitHub Pages

如果你使用 GitHub Pages，你可以将 Surge 项目与你的 GitHub 存储库连接，修改 config.yml 文件，添加你的 GitHub 仓库信息。

github:
  owner: "你的 GitHub 用户名"
  repo: "你的仓库名称"

运行以下命令：

surge push --github

设置自定义域名

如果你有自己的域名,可以配置 Surge 使用自定义域名，修改 config.yml 文件，添加 DNS 记录。

domain: "你的域名"

使用插件

Surge 支持插件来扩展功能，你可以安装插件，如评论系统或搜索功能。

surge add plugin comment

部署到其他平台

Surge 也可以部署到 Netlify、Vercel 等其他平台，你可以配置 config.yml 文件，添加相应的部署配置。

要更新你的网站内容,你可以重新运行 surge push 命令，或者直接编辑文件然后再次部署。

高级功能

• 模板：Surge 提供多种模板，包括博客、项目展示等，你可以选择适合你需求的模板。
• 多页面：你可以在 content 文件夹中创建多个页面，并通过配置实现多页面导航。

常见问题

• 如何配置域名？

  • 修改 config.yml 文件，添加 domain 和 dns 配置。

• 如何添加图片？

  • 在 Markdown 文件中使用 ![图片名称](图片路径) 格式。

• 如何使用评论系统？

  • 安装插件,如 comment，然后在 Markdown 文件中添加 <!-- comment:内容 --> 标记。

• 如何自定义样式？

  • 在 config.yml 文件中添加 CSS 插件，或者在 Markdown 文件中直接添加 CSS 类。

Surge 是一个简单易用的静态网站生成器，适合快速创建和部署网站，通过上述步骤，你可以快速上手 Surge，创建自己的静态网站。