Clay

KO | EN

gitlite — search

#python #ai #golang #go #android #deep-learning #linux #macos #nodejs #windows #cli #kubernetes #vue #security

(★ 20)

Clay —— 一款仿 Claude 审美的 Typora 主题，暖纸质感、明暗双色，克制耐看。

Clay Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Clay — Typora 主题(明 / 暗)

> A warm, paper-textured Typora theme (light + dark), inspired by the claude.ai design language.

[![License](https://img.shields.io/badge/License-MIT-d97757)](https://raw.githubusercontent.com/chaun-yi7/Clay/main/LICENSE)
[![LINUX DO](https://img.shields.io/badge/LINUX%20DO-社区-f5a623?logo=discourse&logoColor=white)](https://linux.do)

一对以 **claude.ai 官网设计语言**为蓝本的 Typora 主题:暖白纸感的浅色 `clay` 与暖灰深底的深色 `clay-dark`。配色对齐官网实测色板(陶土橙 Clay `#d97757` + 暖灰中性色),排版为衬线标题 + 无衬线正文,所有功能区块明暗**结构完全对称**(180 对规则逐条配对、零单边差异)。

- 适配环境:**Typora 1.13.4 / Windows**(1.5+ 版本的语法块均有覆盖;含 macOS seamless 兼容规则)
- 零网络依赖:不引用任何在线字体,离线 / 弱网 / 大陆网络环境下无渲染阻塞
- 中英混排优化:标题走宋体系衬线回退、正文走苹方 / 雅黑回退、等宽含更纱黑体回退

---

## 预览

**浅色 · Clay**

![Clay 浅色预览](https://raw.githubusercontent.com/chaun-yi7/Clay/main/screenshots/clay-light.png)

**深色 · Clay Dark**

![Clay 深色预览](https://raw.githubusercontent.com/chaun-yi7/Clay/main/screenshots/clay-dark.png)

> 上图为主题渲染效果预览;实际以 Typora 中体验为准(建议配合「一体化」窗口样式)。

---

## 一、安装

### 文件构成

| 文件 | 说明 |
|---|---|
| `clay.css` | 浅色主题(主文件,单文件自包含) |
| `clay-dark.css` | 深色主题(与浅色逐区块对称) |

### 主题目录

把两个 `.css` 复制到 Typora 的主题目录:

| 平台 | 路径 |
|---|---|
| Windows | `%APPDATA%\Typora\themes\` |
| macOS | `~/Library/Application Support/abnerworks.Typora/themes/` |
| Linux | `~/.config/Typora/themes/` |

> 在 Typora → 文件 → 偏好设置 → 外观 → **打开主题文件夹**,可直接跳到该目录。

### 启用 / 更新

- **启用**:Typora → 文件 → 偏好设置 → 外观 → 主题,选择 `Clay` 或 `Clay Dark`
- **窗口样式选「一体化」**(强烈建议):偏好设置 → 外观 → 窗口样式 → **一体化**,标题栏 / 侧栏 / 正文同底融为一体,是本主题的推荐形态;切换后需**重启 Typora** 生效
- **修改 CSS 后生效**:切走主题再切回,或重启 Typora(Typora 不热载主题)
- **改样式前先备份**:编辑前复制一份 `.css`(或用 git 版本管理),便于回滚

> [!TIP]
> 本主题是按**一体化(Seamless)窗口样式**调校的——侧栏、标题栏、正文共用暖色底,窗框细线也随主题走。选「经典」样式同样能用,但一体化观感明显更完整。

---

## 二、设计语言

### 色板(两级强调色体系)

核心原则:**Clay 橙 `#d97757` 只做装饰**(引用条、光标、复选框、悬停底色、标记点),**正文级可读文本一律用加深的 `--accent-text-color`**,保证 WCAG AA(≥4.5:1)。

| 角色 | 浅色 | 深色 |
|---|---|---|
| 页面底色 | `#f8f8f6` 暖白 | `#1f1f1e` 暖黑 |
| 正文 | `#121212` | `#d5d4cb` |
| 装饰强调 `--accent-color` | `#d97757` | `#d97757` |
| 文本强调 `--accent-text-color` | `#ae5630`(4.73:1) | `#d97757`(深底上 4.7:1,可直接作文本) |
| 淡橙底上的文本(侧栏激活 / 标签 / 脚注) | `#9a4a28`(5.35:1) | `#d97757` |
| 引用底 / 侧栏底 | `#efeeeb` | `#262625` / `#171716` |

### 字体栈(全部本地回退,无网络请求)

| 用途 | 栈 |
|---|---|
| 标题 `--font-heading` | Anthropic Serif → Söhne Serif → ui-serif → Georgia → 宋体 / 思源宋体 |
| 正文 `--font-body` | Anthropic Sans → Inter → Söhne → Segoe UI → 苹方 / 微软雅黑 |
| 等宽 `--font-mono` | Anthropic Mono → Fira Code → JetBrains Mono → Consolas → 更纱黑体 Mono SC |
| 界面 `--font-ui` | 同正文系,用于菜单 / 对话框 / 表单控件 |

装了 Inter / Fira Code / 更纱黑体效果更佳;一个都没装也能正常回退到系统字体。

### 版式

- 正文列宽 820px 居中(≥1400px 宽屏放宽到 880px;窄窗 ≤768px 收边距),行高 1.75,字距 0.01em
- 数字启用等宽表格数字(`tabular-nums`),表格 / 数据列天然对齐
- 文档首元素顶距收窄(以标题开头时不留大空白)

---

## 三、内容渲染功能

### 标题
- h1 `2.2em / 700` + 下边框;h2 `1.7em` + **陶土色半透明下划线**(浅 22% / 深 28%,`color-mix` 渐进增强);h3–h5 递减 600;h6 小型大写 + 弱化灰,当"眉题"用
- 标题内联代码不放大缩小(`font-size: inherit`)

### 列表
- 无序列表标记点 = Clay 橙(装饰);**有序列表编号 = 深陶土**(可读级);混合嵌套时按**直接父级**取色,互不串染
- **任务列表**:复选框绝对定位、精确对齐条目**首行**(长换行 / 多段 / 粗体连内联代码均不漂移,像素级 delta=0 验证);勾选态陶土橙(`accent-color`);悬停轻微放大不推挤文本
- 列表内图片:块级左对齐、带上下间距,不与文字挤在一行

### 引用块
Clay 4px 左条 + 暖灰底 + 右侧圆角,**直立不斜体**;嵌套引用右内距收平。

### 表格(卡片式)
圆角 + 浅阴影 + 外边框;表头着色 + 2px 强分隔;行悬停淡橙底;末行无底线。

### 内联代码 / 高亮 / 键帽
- `code`:暖底色块 + 细边框 + 红棕字(600 权重),跨行折行时两端圆角均保留(`box-decoration-break: clone`)
- `==高亮==`:暖棕半透明底(非刺眼默认黄),同样支持跨行
- `<kbd>`:键帽样式(双倍下边框模拟按键立体感);`<abbr>` 虚线底 + help 光标

### 代码围栏(编辑态 CodeMirror)
- Mac 风格圆角卡片,完整语法配色:关键字紫 / 字符串绿 / 数字橙 / 标签属性蓝 / 注释灰斜体,明暗两套独立调色
- 光标 2px 陶土色;选区用主题选择色;开启行号时行号槽透明底 + 右分隔线
- 围栏内代码不继承内联代码的边框 / 底色 / 加粗(导出 HTML 也不串色)

### 源代码模式(`Ctrl + /`)
- 全区等宽字体(含代码 span / 表格行等 Typora 默认强制通用等宽的 token,统一为主题等宽栈,表格竖线对齐)
- 内容居中成列(820px,与正文一致)
- Markdown token 重着色:标题行陶土、注释灰、字符串绿、数字橙、链接 / HTML 标签蓝(修复 Typora 默认色在深底上 2.5:1 不可读的问题)
- 光标陶土色;当前行淡色高亮

### 其他块级元素
- **GitHub 警告块** `> [!NOTE/TIP/IMPORTANT/WARNING/CAUTION]`:五色左条 + 同色调淡底,明暗两套(深色用 GitHub Dark 色值)
- **YAML Front Matter**:虚线边框面板 + 等宽字体
- **数学公式**:行内公式底色块;公式块工具提示浮层阴影 + 圆角(含官方同款定位修正)
- **Mermaid 图表**:圆角边框面板;深色主题下保持浅底面板(图表默认配色按浅底设计,刻意不翻转)
- **脚注**:上标做成暖底小徽章;脚注区顶部分隔线
- `~~删除线~~` 弱化灰;`<u>` / `<ins>` 陶土色下划线;`#标签` 暖底圆角小片
- 图片:块级居中 + 圆角 + 浮起阴影,悬停轻微放大;`[TOC]` 目录卡片化

---

## 四、编辑器体验

- **光标**(正文 / 源码 / 围栏)统一陶土色
- **选区**:暖橙底;`Ctrl+F` 搜索命中:更深暖橙底(选中命中单独一档)
- **专注模式(F8)**:非焦点段落整体压暗为弱化灰——**链接 / 内联代码 / 粗体 / 高亮一并压暗**不残留亮色;代码围栏与源码模式同步压暗非活动行;图片 / SVG 降透明度;引用条同步减淡;紧凑列表有防"自灰"保护
- **打字机 / 滚动**:自定义细滚动条(悬停加深),不突兀
- **侧栏**:文件树 / 文件列表 / 大纲激活项 = 淡橙底 + 3px 陶土左条 + 加深文字;悬停淡橙底;全局搜索结果激活行同色系(`--active-file-text-color`)
- **快速打开(Ctrl+P)**:圆角浮层 + 激活行同侧栏色系
- **搜索替换面板**:主题化输入框;选项按钮激活态陶土底白字
- **输入框聚焦边框**(搜索框 / 对话框输入等)= 陶土色(压掉 Typora 默认的 Bootstrap 蓝,`--primary-color`)
- **菜单 / 对话框**:起始页大菜单、右键菜单、下拉菜单、偏好设置、模态框全部主题化;主按钮陶土底白字(官网 CTA 同款),悬停加深
- **窗框细线** `--window-border`:侧栏页签 / 文件行分隔 / 下拉分割线等按主题边框色走(深色下不再露浅色发丝线)
- 表格编辑工具条 / 底部字数统计 / 源码切换按钮激活态 / 工具提示(深底白字)均已主题化
- 编辑期元 token(标题 `{#id}` 属性、HTML 注释)弱化显示

---

## 五、导出与打印

- `@media print`:正文缩至 13px;表格 / 代码块 / 引用 / 图片 / 警告块**不跨页截断**;标题后不孤立分页;段落孤行寡行控制(orphans/widows 3)
- 导出 PDF / 打印时自动去掉图片、表格、代码块阴影(纸面干净)
- 无在线字体引用 → 导出不会卡在网络请求
- 深色主题导出 PDF 保持深色(与 Typora 官方 night 主题行为一致,刻意不强制翻白)

---

## 六、对比度与可读性承诺

- 所有**正文级**文本 token ≥ 4.5:1(AA):正文、链接、标题、引用、脚注、标签、侧栏激活文字等均实测达标
- 专注模式压暗色 = 弱化灰(浅 `#7b7974` / 深 `#97958c`),**同时定义了 Typora 内部的 `--blur-text-color`**,连 Typora 基础样式自己的压暗规则也走主题灰(修复深色下默认 `#C8C8C8` "越压越亮"的问题)
- 已知惯例值(刻意保留):语法高亮字符串 / 数字在浅色下 3.7–3.9:1(通行的代码高亮密度取舍)、h6 眉题 4.09:1(官网原生 token)、主按钮白字压陶土底(官网同款)

---

## 七、自定义入口(改 `:root` 变量即可)

| 想改什么 | 动哪个变量 |
|---|---|
| 换强调色 | `--accent-color`(装饰)+ `--accent-text-color`(文本级,注意对比度) |
| 换字体 | `--font-heading` / `--font-body` / `--font-mono` |
| 列宽 | `#write { max-width }`(两处:默认 820 与宽屏 880)|
| 代码高亮配色 | `--code-keyword/string/number/symbol/muted-color` |
| 表格 / 引用底色 | `--table-*` / `--quote-*` |
| 侧栏激活色系 | `--active-file-bg/border/text-color` |

明暗两文件区块顺序完全一致,改动请**成对**进行以维持对称。

---

## 八、质量基线

开发中经过五轮审查:静态分析(括号 / 变量 / 选择器配对)、真实浏览器渲染(Playwright 计算样式 + 截图)、**与 Typora 真实 base.css 同层加载的级联回归测试**、WCAG 对比度实算、对抗式代理复查。当前状态:两文件 184/184 括号平衡、180 对规则零单边零属性差、零悬空变量。

日常自检:随手用一篇含标题 / 列表 / 任务列表 / 表格 / 代码块 / 引用 / 警告块 / 公式的 Markdown,在明暗两主题下逐项对照(重点看:源码模式配色、对话框无蓝色残留、深色窗框、复选框首行对齐、专注模式压暗方向)。

---

## 九、致谢

感谢 [**LINUX DO**](https://linux.do) 社区的交流与反馈。

> LINUX DO 是一个真诚、友善、团结、专业的技术社区。*Where possible begins.*

---

## License

[MIT](./LICENSE)

本主题在视觉上参考了 [claude.ai](https://claude.ai) 的公开设计语言(配色 / 版式),与 Anthropic 无隶属或背书关系。"Claude" 为 Anthropic 的商标,此处仅作事实性引用。

---

*主题文件:`clay.css` 与 `clay-dark.css`(放入 Typora 主题目录) · 基于 Typora 1.13.4 验证 · 2026-07*

Clay

Clay Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Clay

Clay Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README