跳转到内容
This is an unmaintained snapshot of the Astro v4 docs. View the latest docs.

创作内容

Astro 是以内容为中心的网站的完美选择:博客、营销网站、作品集等!

Astro 帮助你创作和展示你的内容。你可以直接在 Astro 中使用 Markdown/MDX 写作博客,也可以从你的无头 CMS 中获取内容。 Astro 让你围绕你的内容建立一个网站:你可以在你的页面上添加一个布局,创建一个文章的列表,并建立一个 RSS 订阅源,让读者可以订阅。

在 Astro 中,你可以通过多种方式创作内容:

Markdown 是一种便捷的语法,用于编写具有基本格式和通用元素的富文本,如标题列表和图像。 Astro 在你的项目中内置了对 Markdown 文件的支持。

在代码编辑器中创建并编写 .md 文件,或者使用一个你最喜欢的 Markdown 编辑器中编写现有文件。一些在线的 Markdown 编辑器,如 StackEditDillinger ,甚至允许你与存储在 GitHub 上的 Astro 仓库编写和同步你的工作。

了解更多关于 在 Astro 中编写 Markdown 内容 的信息。

如果你在项目中使用了 Astro MDX 集成,你还可以使用 .mdx 文件编写内容,它可以在 Markdown 中编写 JavaScript 表达式和组件。这包括静态 Astro 组件 和交互式 框架组件。这允许你在文本中添加 UI 元素,如横幅或交互式轮播图。

直接在你的代码编辑器中编写和编辑 .mdx 文件 和你的项目文件。MDX 文件是 Astro 中 支持的页面文件类型,也可以用作 内容集合条目

了解更多关于 在 Astro 中使用 MDX 的信息。

在现有的内容管理系统(CMS)中编写博客文章,例如 Storyblok,WordPress 或 Contentful。一些 CMS,像 Storyblok,提供了官方的 Astro 集成。其他的可以使用公开的 JavaScript SDK 来让 Astro 页面 获取你的远程内容

探索我们的 CMS 指南 集合和 Astro CMS 集成,以获取广泛的资源选择。

位于 src/pages 目录的 Markdown 和 MDX 文件将使用 Astro 的 基于文件路由 自动生成页面,构建一个与文件路径相对应的 URL。

你还可以选择将 Markdown 和 MDX 文件保存在 src/pages 目录之外,然后 导入内容.astro 页面。

Astro 自带的 内容集合 提供了一种强大的、类型安全的方式来处理你的 src/content 目录中的 Markdown、MDX 或 Markdoc 内容。

你还可以从项目之外的源 远程获取 markdown。这将需要你自己的 Markdown 解析器,或者使用社区集成(例如 astro-remote)。

为了构建常用功能来组织和显示你的内容,例如博客存档或博客的每个标签页面,Astro 允许你 获取文件名和元数据,或者使用 内容集合辅助工具 查询你的条目并且生成页面内容和路由。

若要发布给更广泛的受众,请 创建可分发给源读者的 RSS 源

除了官方 @astrojs/mdx@astrojs/markdoc 集成,这里有一些第三方 社区集成 也可用于处理 Astro 项目中的内容。

贡献

你有什么想法?

社区