外观主题
阅读语言

建站小教程

欢迎入驻！这份教程 5 分钟看完，帮你避开 90% 的建站坑。

你的主页在哪

上传文件后，你的主页地址是：

https://yxpil.com/@你的用户名/

你在面板上传的所有文件，都放在这个「小房间」里。比如你上传了 cat.jpg，别人就要通过 /@你的用户名/cat.jpg 才能看到它。

什么是相对路径（最容易踩的坑！）

相对路径 = 从你自己的小房间出发找文件的路。

假设你的目录长这样：

index.html
css/
  index.css
images/
  cat.jpg

在 index.html 里应该这样写：

✅ 正确（相对路径）：

<link rel="stylesheet" href="css/index.css">
<img src="images/cat.jpg">

❌ 错误（以 / 开头的绝对路径）：

<link rel="stylesheet" href="/css/index.css">
<img src="/images/cat.jpg">

为什么错？以 / 开头意味着「从整个网站的最根出发」，也就是去 yxpil.com/css/index.css 找——那里不是你的房间，只会得到 404。

一句话记住：除非你想引用主站的公共文件，否则路径开头不要加 /。

什么是 Markdown（.md）

Markdown 是一种「带格式的记事本」写法：写起来像纯文本，展示时自动变成漂亮的网页。

新建一个 index.md 上传，它就会自动成为你的主页（不写 index.html 也可以！）：

# 你好，我是小鲨

欢迎来到我的房间！

- 喜欢编程
- 喜欢音乐

[点这里去我的B站](https://space.bilibili.com/xxx)

常用写法对照：

你写 得到
# 标题 大标题
**加粗** 加粗
[文字](网址) 超链接
![说明](图片.png) 显示图片
- 项目 列表
> 引用 引用块

小技巧：在 md 最上面加上这段，可以自定义浏览器标签页标题：

---
title: 我的主页
---

推荐的目录结构

index.html        ← 主页入口（用 index.md 也行）
css/              ← 样式文件
js/               ← 脚本文件
images/           ← 图片

想给 Markdown 穿自己的衣服？

在 md 文件开头的 front-matter 里加一行 css: 就行：

---
title: 我的作品
css: style.css
---
  • css: style.css —— 引入同目录下的 style.css（默认排版自动关闭，样式完全由你做主）
  • css: none —— 直接关掉默认排版
  • 或者直接在 md 正文里写 <style>...</style>，默认排版也会自动让位

提示：引用的 css 文件记得一起上传，写相对路径（如 style.css、css/main.css）。

常见坑清单

  • ❌ 路径以 / 开头 → 改成相对路径，如 css/xxx.css
  • ❌ 文件名大小写不一致 → Cat.jpg 和 cat.jpg 是两个文件
  • ❌ 引用了没上传的文件 → 传之前对照 html 检查每个引用都传了
  • ❌ 传完没变化 → 主页更新后按 Ctrl+F5 强制刷新再看

想用自己已有的网站？

如果你的小站已经有独立域名，可以只上传一个「跳转页」index.html——别人访问你的主页时会自动前往你的域名。找管理员要一份模板，或者抄 Duo 的作业～

上传与审核

  1. 个人面板 → 我的文件，上传文件（每人 20MB，会员 20GB）
  2. 上传 index.html 或 index.md 后等待管理员审核
  3. 通过后主页公开，并出现在屋友目录

有问题欢迎在社区里 @管理员！

🧩 模板

不想从零开始写？打开个人面板的「文件列表」，右上角有「模板」按钮：

  • 📝 Markdown 极简主页（index.md）
  • 📔 Markdown 日记本（diary.md）
  • 🪪 个人名片单页（index.html）
  • 📷 图片相册页（gallery.html）
  • 🔗 自有域名跳转页（index.html）

点「使用此模板」→ 内容自动填进编辑器 → 改一改 → 保存，网站就建好了。

更省事：现在直接在个人面板「🔗 我的网站（域名迁移）」里填你的网址并保存，平台会自动把 /@你的用户名/ 整站 302 过去，连跳转页都不用传。