Obsidian 学习笔记

Appearance

自定义主题进阶 ​

在「主题定制」基础上，本指南将介绍更多进阶的 CSS 自定义技巧。

CSS 变量 ​

Obsidian 内置变量 ​

Obsidian 提供了大量 CSS 变量用于主题定制：

css
/* 颜色变量 */
--background-primary: #ffffff;
--background-secondary: #f5f5f5;
--text-normal: #333333;
--text-muted: #666666;
--accent-color: #7c3aed;

/* 字体变量 */
--font-text: 'Source Sans Pro', sans-serif;
--font-monospace: 'JetBrains Mono', monospace;
--font-interface: 'Inter', sans-serif;

/* 间距变量 */
--size-4-1: 4px;
--size-4-2: 8px;
--size-4-3: 12px;
--size-4-4: 16px;

覆盖变量 ​

在 obsidian.css 或 CSS 片段中覆盖：

css
/* 放在 .obsidian/snippets/custom.css */
:root {
  --background-primary: #fafafa;
  --text-normal: #1a1a1a;
  --accent-color: #6366f1;
  --font-text: 'Noto Sans SC', sans-serif;
}

暗色模式变量 ​

css
.theme-dark {
  --background-primary: #1e1e1e;
  --background-secondary: #252525;
  --text-normal: #e0e0e0;
  --text-muted: #a0a0a0;
}

高级定制 ​

自定义标题样式 ​

css
/* 标题样式定制 */
.HyperMD-header-1,
.markdown-preview-view h1 {
  font-size: 2.5em;
  font-weight: 700;
  border-bottom: 2px solid var(--accent-color);
  padding-bottom: 0.3em;
}

.HyperMD-header-2,
.markdown-preview-view h2 {
  font-size: 1.8em;
  font-weight: 600;
  color: var(--accent-color);
}

.HyperMD-header-3,
.markdown-preview-view h3 {
  font-size: 1.4em;
  font-weight: 500;
}

自定义引用块 ​

css
/* 引用块样式 */
.markdown-preview-view blockquote {
  border-left: 4px solid var(--accent-color);
  background: linear-gradient(to right, rgba(124, 58, 237, 0.1), transparent);
  padding: 1em 1.5em;
  margin: 1em 0;
  border-radius: 0 8px 8px 0;
}

blockquote p {
  margin: 0;
}

自定义代码块 ​

css
/* 代码块样式 */
.markdown-preview-view pre {
  background: var(--background-secondary);
  border-radius: 8px;
  padding: 1em;
  border: 1px solid var(--background-modifier-border);
}

code {
  background: var(--background-secondary-alt);
  padding: 2px 6px;
  border-radius: 4px;
  font-size: 0.9em;
}

自定义链接样式 ​

css
/* 内部链接 */
.internal-link {
  color: var(--accent-color);
  text-decoration: none;
  border-bottom: 1px dotted var(--accent-color);
  transition: all 0.2s ease;
}

.internal-link:hover {
  background: rgba(124, 58, 237, 0.1);
}

/* 外部链接 */
.external-link {
  color: var(--text-accent);
  text-decoration: none;
}

.external-link::after {
  content: "↗";
  font-size: 0.8em;
  margin-left: 2px;
}

自定义列表样式 ​

css
/* 任务列表 */
.task-list-item-checkbox {
  appearance: none;
  width: 18px;
  height: 18px;
  border: 2px solid var(--text-muted);
  border-radius: 4px;
  cursor: pointer;
  transition: all 0.2s ease;
}

.task-list-item-checkbox:checked {
  background: var(--accent-color);
  border-color: var(--accent-color);
}

.task-list-item-checkbox:checked::after {
  content: "✓";
  color: white;
  font-size: 12px;
  display: flex;
  justify-content: center;
  align-items: center;
}

/* 已完成任务 */
.task-list-item.is-checked {
  color: var(--text-muted);
  text-decoration: line-through;
}

响应式设计 ​

移动端适配 ​

css
/* 移动端样式 */
@media (max-width: 768px) {
  /* 增大触摸目标 */
  .nav-folder-title,
  .nav-file-title {
    padding: 12px 16px;
  }

  /* 简化界面 */
  .workspace-ribbon {
    display: none;
  }

  /* 调整字体大小 */
  .markdown-preview-view {
    font-size: 16px;
  }
}

宽屏优化 ​

css
/* 宽屏优化 */
@media (min-width: 1400px) {
  .markdown-preview-view {
    max-width: 900px;
    margin: 0 auto;
  }

  /* 双栏布局 */
  .markdown-preview-view .two-column {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 2em;
  }
}

动画效果 ​

平滑过渡 ​

css
/* 全局过渡 */
body {
  transition: background-color 0.3s ease, color 0.3s ease;
}

/* 按钮悬停 */
button {
  transition: all 0.2s ease;
}

button:hover {
  transform: translateY(-1px);
  box-shadow: 0 2px 8px rgba(0,0,0,0.15);
}

入场动画 ​

css
/* 笔记入场动画 */
.markdown-preview-view {
  animation: fadeIn 0.3s ease;
}

@keyframes fadeIn {
  from {
    opacity: 0;
    transform: translateY(10px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

自定义组件 ​

彩色标签 ​

css
/* 标签颜色 */
.tag[href="#重要"],
.tag[href="#important"] {
  background: #ef4444;
  color: white;
}

.tag[href="#待办"],
.tag[href="#todo"] {
  background: #f59e0b;
  color: white;
}

.tag[href="#完成"],
.tag[href="#done"] {
  background: #10b981;
  color: white;
}

.tag[href="#想法"],
.tag[href="#idea"] {
  background: #6366f1;
  color: white;
}

自定义徽章 ​

css
/* 状态徽章 */
.badge {
  display: inline-block;
  padding: 2px 8px;
  border-radius: 12px;
  font-size: 0.75em;
  font-weight: 600;
}

.badge-success {
  background: #10b981;
  color: white;
}

.badge-warning {
  background: #f59e0b;
  color: white;
}

.badge-error {
  background: #ef4444;
  color: white;
}

自定义卡片 ​

css
/* 卡片样式 */
.admonition {
  border-radius: 8px;
  padding: 1em;
  margin: 1em 0;
  box-shadow: 0 2px 8px rgba(0,0,0,0.1);
}

.admonition-title {
  font-weight: 600;
  margin-bottom: 0.5em;
}

.admonition.note {
  background: rgba(59, 130, 246, 0.1);
  border-left: 4px solid #3b82f6;
}

.admonition.tip {
  background: rgba(16, 185, 129, 0.1);
  border-left: 4px solid #10b981;
}

.admonition.warning {
  background: rgba(245, 158, 11, 0.1);
  border-left: 4px solid #f59e0b;
}

插件增强 ​

Style Settings 插件 ​

安装 Style Settings 插件后，可以在设置中可视化调整主题：

css
/* Style Settings 配置 */
/* @settings
name: 自定义主题
id: custom-theme
settings:
  - id: heading-color
    title: 标题颜色
    type: variable-color
    default: '#7c3aed'
  - id: font-size-base
    title: 基础字号
    type: variable-number
    default: 16
*/

Minimal Theme Settings ​

使用 Minimal 主题时的额外设置：

  • 字体大小调整
  • 行高调整
  • 颜色方案切换

实用 CSS 片段 ​

紧凑模式 ​

css
/* 紧凑模式 */
.workspace-leaf-content {
  padding: 0;
}

.markdown-preview-view {
  padding: 16px;
}

h1, h2, h3, h4, h5, h6 {
  margin: 0.5em 0 0.3em;
}

p {
  margin: 0.5em 0;
}

阅读模式优化 ​

css
/* 阅读模式 */
.markdown-preview-view.is-readable-line-width {
  max-width: 700px;
  margin: 0 auto;
}

/* 增大行高 */
.markdown-preview-view p {
  line-height: 1.8;
}

/* 段落间距 */
.markdown-preview-view p + p {
  margin-top: 1em;
}

专注模式 ​

css
/* 专注模式 - 淡化非当前段落 */
.markdown-preview-view p:hover,
.markdown-preview-view li:hover {
  opacity: 1;
}

.markdown-preview-view p,
.markdown-preview-view li {
  opacity: 0.6;
  transition: opacity 0.3s ease;
}

提示

CSS 定制是一个迭代过程，建议逐步添加样式，随时预览效果！

INFO

所有自定义样式建议放在 .obsidian/snippets/ 文件夹中，便于管理和迁移。

最后更新：2026年2月22日编辑此页反馈问题