写作模块与文章样式示例
这是一篇可复制、可删改的文章样例,集中展示主题提供的写作模块与常用 Markdown 文章样式。文章标题只保留在 front matter 中,正文从二级标题开始。
基础文字排版
普通段落可以混排中文、English 和 inline code。也可以使用 粗体、斜体、粗斜体、删除线,以及 外部链接。
引用适合摘录、强调或补充背景。
第二段引用可以继续展开说明,并包含
行内代码。
无序列表与任务清单
第一项
- 嵌套项目
- 包含 加粗文本 的项目
第二项
已完成的写作准备
待补充的内容
有序列表
- 确定文章主题。
- 组织内容层级。
- 预览并检查阅读体验。
表格
| 模块 | 用途 | 推荐场景 |
|---|---|---|
| Callout | 强调信息 | 提示、警告、结论 |
| Tabs | 切换内容 | 并列方案、分步骤说明 |
| Folding | 收起内容 | 补充材料、长说明 |
图片
图片应放在站点根目录的 source/images/ 中,再通过站点相对路径引用。下面的图片使用了本地资源:
四级标题
适合展开某个具体问题;主题会为不同层级的标题提供一致的阅读节奏。
五级标题
用于较细的说明,例如配置项、注意事项或术语解释。
六级标题
一般只在较长的技术文章中使用,避免层级过深。
代码块
带语言标识的代码块会获得语法高亮和主题配置的复制按钮。
1 | const greeting = "Hello, Redefine!"; |
1 | npm run clean |
写作模块
以下示例使用 Redefine 2.9.0 推荐的新标签语法;旧的 note、btn、buttons 等标签仍兼容,但已不建议用于新文章。
Callout 提示块
这是无标题的提示块,适合放置简短补充信息。
完成
这是带标题的成功提示块。使用 ::标题 后会自动使用带标题样式。
注意
发布前请确认链接、图片路径与代码示例都能正常工作。
重要
不要将文章图片放进主题目录;升级主题时,主题目录中的自定义资源可能被覆盖。
Button 按钮
阅读 Redefine 文档Grid 网格
网格可将多个按钮或内容卡片排成多列:
Folding 折叠
点击展开写作检查清单
- 标题、日期、标签与分类已填写。
- 标题层级没有跳跃,正文没有重复一级标题。
- 本地图片位于
source/images/,并使用站点相对路径。 - 执行
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 进行许可。
评论