

md 标准模板。#
字段配置与功能说明#
你可以直接复制下面这里的内容:
---
title: '文章标题' # 【必填】显示在文章顶部及浏览器标签页
publishDate: 'May 10, 2025' # 【必填】发布日期,前台列表按此排序。格式如 'May 10, 2025' 或 2024-01-01
updatedDate: 'June 12, 2025' # 【可选】更新日期,显示“最后更新于”,对 SEO 友好
slug: 'my-custom-url' # 【可选】固定网址路径,改文件名也不会导致 404(生效)
description: '文章摘要描述' # 【必填】列表卡片简介,同时用于搜索引擎 SEO 抓取
draft: false # 【可选】是否为草稿。true 为草稿不显示,false 为正常发布,默认 false
tags: # 【可选】用于标签云和文章分类
- 标签1
- 标签2
language: '中文' # 【可选】声明本文语言,适配多语言排版
heroImage: { src: './thumbnail.jpg', color: '#9698C1' } # 【可选】封面图配置。必须是对象!src 为同目录相对路径,color 为加载前占位色
---
正文从这里开始写...
markdown使用说明:#
- 代码块内#后面的内容在实际网页构建时会被自动忽略,不会显示在正文中,可删可不删。
- 请确保 heroImage 的 src 指向的图片(如 thumbnail.jpg)与这个 .md 文件放在同一个文件夹里。如果不需要封面图,直接把 heroImage 这一整行删掉即可。
- 冒号:后面必须有空格才能写代码或注释。
- 严禁使用 Tab 键进行缩进,tags 下面的 - 前面必须用空格。
mdx 标准模板。#
MDX 的头部配置与 MD 完全一致,最大的区别在于结束的 --- 之后,可以紧跟着引入组件并在正文中使用它们。
字段配置与功能说明#
你可以直接复制下面这里的内容:
---
title: '文章标题' # 【必填】显示在文章顶部及浏览器标签页
publishDate: 'May 10, 2025' # 【必填】发布日期,前台列表按此排序。格式如 'May 10, 2025' 或 2024-01-01
updatedDate: 'June 12, 2025' # 【可选】更新日期,显示“最后更新于”,对 SEO 友好
slug: 'my-custom-url' # 【可选】固定网址路径,改文件名也不会导致 404(生效)
description: '文章摘要描述' # 【必填】列表卡片简介,同时用于搜索引擎 SEO 抓取
draft: false # 【可选】是否为草稿。true 为草稿不显示,false 为正常发布,默认 false
tags: # 【可选】用于标签云和文章分类
- 标签1
- 标签2
language: '中文' # 【可选】声明本文语言,适配多语言排版
heroImage: { src: './thumbnail.jpg', color: '#9698C1' } # 【可选】封面图配置。必须是对象!src 为同目录相对路径,color 为加载前占位色
---
import { Aside } from 'astro-pure/user' # 【关键】mdx专属!在 --- 下方引入你需要的组件
正文从这里开始写,在.mdx 中,你可以直接像写 HTML 一样使用刚刚引入的组件:
<Aside type='tip' title='这是一个提示框'>
这里是提示框组件内部的文字内容。
</Aside>mdx使用说明:#
- 代码块内#后面的内容在实际网页构建时会被自动忽略,不会显示在正文中,可删可不删。
- import 语句必须紧跟在头部 --- 的下方,不能写在其他地方。
- 请确保 heroImage 的 src 指向的图片(如 thumbnail.jpg)与这个 .mdx 文件放在同一个文件夹里。如果不需要封面图,直接把 heroImage 那一整行删掉即可。
- 冒号:后面必须有空格才能写代码或注释。严禁使用 Tab 键进行缩进。