写作模块与文章样式示例

Lei

这是一篇可复制、可删改的文章样例,集中展示主题提供的写作模块与常用 Markdown 文章样式。文章标题只保留在 front matter 中,正文从二级标题开始。

基础文字排版

普通段落可以混排中文、English 和 inline code。也可以使用 粗体斜体粗斜体删除线,以及 外部链接

引用适合摘录、强调或补充背景。

第二段引用可以继续展开说明,并包含 行内代码


无序列表与任务清单

  • 第一项

    • 嵌套项目
    • 包含 加粗文本 的项目
  • 第二项

  • 已完成的写作准备

  • 待补充的内容

有序列表

  1. 确定文章主题。
  2. 组织内容层级。
  3. 预览并检查阅读体验。

表格

模块 用途 推荐场景
Callout 强调信息 提示、警告、结论
Tabs 切换内容 并列方案、分步骤说明
Folding 收起内容 补充材料、长说明

图片

图片应放在站点根目录的 source/images/ 中,再通过站点相对路径引用。下面的图片使用了本地资源:

由圆点、线条和文字组成的 Redefine 写作示例插图

四级标题

适合展开某个具体问题;主题会为不同层级的标题提供一致的阅读节奏。

五级标题

用于较细的说明,例如配置项、注意事项或术语解释。

六级标题

一般只在较长的技术文章中使用,避免层级过深。

代码块

带语言标识的代码块会获得语法高亮和主题配置的复制按钮。

1
2
3
const greeting = "Hello, Redefine!";

console.log(greeting);
1
2
npm run clean
npm run build

写作模块

以下示例使用 Redefine 2.9.0 推荐的新标签语法;旧的 notebtnbuttons 等标签仍兼容,但已不建议用于新文章。

Callout 提示块

这是无标题的提示块,适合放置简短补充信息。

完成

这是带标题的成功提示块。使用 ::标题 后会自动使用带标题样式。

注意

发布前请确认链接、图片路径与代码示例都能正常工作。

重要

不要将文章图片放进主题目录;升级主题时,主题目录中的自定义资源可能被覆盖。

Button 按钮

阅读 Redefine 文档

Grid 网格

网格可将多个按钮或内容卡片排成多列:

Folding 折叠

点击展开写作检查清单
  1. 标题、日期、标签与分类已填写。
  2. 标题层级没有跳跃,正文没有重复一级标题。
  3. 本地图片位于 source/images/,并使用站点相对路径。
  4. 执行 npm run clean && npm run build 验证构建。
默认展开的补充说明

open=true 可让折叠块在页面初始渲染时展开。

Tabs 分栏

先写出清晰的小标题,再为每一节补充一个核心观点。长文章中,Tabs 适合承载并列内容,避免页面过长。

延伸功能

主题还支持 Mermaid 等插件功能;启用前请按照主题配置和对应插件文档完成安装。本示例只使用当前站点已提供的写作模块,因此无需额外依赖即可构建。

  • 标题: 写作模块与文章样式示例
  • 作者: Lei
  • 创建于 : 2026-07-29 10:00:00
  • 更新于 : 2026-08-01 11:04:25
  • 链接: https://steins.top//writing-style-demo/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论