返回内容中心
文章

Markdown 示范文章

这是一个 Markdown 文件的最佳示范,展示如何正确编写 frontmatter 和内容结构。

S
Spark Liang
January 20, 2025
示范 Markdown 博客

Markdown 示范文章

欢迎查看这个 Markdown 文件的示范!这个文件展示了如何在我们的博客系统中正确使用 Markdown 格式。

测试图片 - SVG

封面图片

关键特点

1. Frontmatter 结构

每个 Markdown 文件都需要包含以下 frontmatter 字段:

  • title: 文章标题
  • pubDate: 发布日期
  • author: 作者名称
  • authImage: 作者头像路径
  • image: 文章封面图片路径
  • tags: 标签数组
  • summary: 文章摘要
  • type: 文章类型
  • featured: 是否为推荐文章(可选)

2. 内容结构

  • 使用标准的 Markdown 语法
  • 支持标题、列表、链接、图片等
  • 保持良好的层级结构

3. 图片路径

图片路径使用相对路径,例如:/blog/image1.png

下面是一个实际的图片示例:

示例图片 1

这张图片展示了如何在 Markdown 中正确引用图片文件。

4. 多图片展示

我们也可以在文章中展示多张图片:

示例图片 2

示例图片 3

最佳实践

  1. 保持简洁的 frontmatter:只包含必要的元数据
  2. 使用语义化的标题:帮助读者快速理解内容结构
  3. 适当的标签:便于分类和搜索
  4. 清晰的摘要:让读者快速了解文章内容

总结

这个示范文件展示了在我们博客系统中使用 Markdown 的标准格式。遵循这个格式,你的文章将能够在博客页面中正确显示。

Contact us

Email: examplemail.com Phone: +123 456 789 Address: 1234 Street Name, City Name, Country Name
2024 Positivus - Made With Astro by Manul  Credits ( Olga, Esteban) & Licence