创作内容

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

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

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

  • 在 Markdown 文件中 (.md or 其他扩展名),旨在使编写富文本内容变得容易。
  • 在 MDX (.mdx) 文件中,允许你在文档中包含组件和动态表达式。
  • 使用第三方内容管理系统 (CMS),然后将该内容拉取到 .astro 页面中。
  • 其他选项(内容复杂的页面中不常用)包括 .astro 文件.html 文件

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

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

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

如果你在项目中集成了 MDX,你还可以使用 .mdx 文件编写内容,这样你就可以在 Markdown 中编写 JavaScript 表达式和自定义组件。这包括静态 Astro 组件 和交互式框架组件。在你的文本中添加UI元素,如横幅或交互式轮播图,将你的内容变成完整的网页。

与你的项目文件一起,直接在你的代码编辑器中编写和编辑 .mdx 文件。

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

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

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

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

如果您在 CMS 中编写内容,你可以获取你的文章,并使用动态路由使用一个 .astro 文件为每个帖子生成路由。在 Astro 的默认静态模式下,这些路由是在构建时生成的。如果选择加入 SSR 模式,则会在运行时响应请求并按需获取内容。

为了构建常用功能来组织和显示您的内容,例如博客存档或博客的每个标签页面,Astro 允许你获取文件名和元数据,并使用它们生成页面内容和路由。

除了官方 @astrojs/mdx 集成,有几个第三方社区集成可用于处理 Astro 项目中的内容。