链接与导航

Methanol 采用基于文件的路由机制。站内链接可直接引用“路由路径”。

内部链接

引用站内路由（无需文件扩展名）：

[写作基础](./writing)

渲染为：写作基础

若页面发生迁移或重命名，请务必同步更新链接路径。

子路径部署配置（site.base）

若站点需部署于子路径下（例如 https://example.com/docs/），请设置 site.base: '/docs/'，并避免在内容中硬编码如 /blog/post 的绝对根路径。

建议优先使用相对链接：

[下一篇](./next-post)
[返回博客](../blog/)

若需在 MDX/JSX 中生成基于根路径的链接，请使用 ctx.withBase 进行包装：

<a href={ctx.withBase('/blog/post')}>阅读</a>

外部链接

引用外部站点需使用完整 URL：

[Example](https://example.com)

渲染为：Example

导航排序

可通过 Frontmatter 精确控制导航顺序与可见性：

• weight: 数值越小排序越靠前
• hidden: 在侧边栏导航中隐藏
• isRoot: 用于 index.mdx，定义导航根节点

完整规则详见 Frontmatter 参考。