Markdown 写作指南(示例)


这篇文章演示常用 Markdown 语法的渲染效果,写完新文章前可以对照检查排版。

标题层级

上面是二级标题。一般来说正文从 ## 开始,# 留给文章标题。

三级标题

四级标题

强调与列表

支持粗体斜体行内代码删除线

无序列表:

  • 第一项
  • 第二项
    • 嵌套项

有序列表:

  1. 第一步
  2. 第二步
  3. 第三步

引用

学而不思则罔,思而不学则殆。

—— 《论语》

表格

功能 实现方式 配置文件
文章 Content Collections src/content/blog/
标签 动态路由 src/pages/tags/
搜索 Pagefind npm run build
评论 Giscus src/config.ts
深色模式 localStorage + 媒体查询 导航栏按钮

图片

图片可以使用模板自带的占位图,也可以把自己的图片放到 src/assets/ 后在文章中引用:

占位图片示例

把上面这行换成你自己的图片路径即可。构建时 Astro 会自动优化图片尺寸与格式。

链接

行内链接示例:Astro 官方文档

评论

评论系统尚未配置。请前往 giscus.app生成配置,然后替换 src/config.tsGISCUS 常量的占位符。