MoLan

by czunique
Screenshot of the MoLan Obsidian theme
5
4
3
2
1

Description

This theme supports Dark Mode
This theme supports Light Mode

README file from

Github

MoLan

MoLan is an elegant, low-saturation Chinese ink-wash theme for Obsidian. It combines a warm rice-paper surface with ink blue, mist green, muted coral, and a small set of calm functional colors. The theme is designed for long-form writing and reading: artwork stays at the edge of panes and never sits behind the text line.

MoLan theme preview

Installation

From the Obsidian Community Themes directory

  1. Open Settings → Appearance → Themes in Obsidian.
  2. Select Manage, search for MoLan, and choose Install.
  3. Select Use to activate the theme.

Manual installation

  1. Download the latest theme.css and manifest.json from the GitHub Releases page.
  2. Create the folder <your-vault>/.obsidian/themes/MoLan/.
  3. Put both downloaded files directly in that folder.
  4. In Obsidian, open Settings → Appearance → Themes, then select MoLan.

Customization

MoLan works without the Style Settings plugin and has no required Style Settings options. Use Obsidian's built-in appearance controls to switch between light and dark mode, or add a CSS snippet for more specific changes.

The most useful theme variables are defined at the top of theme.css:

Variable Purpose
--molan-font-ui User-interface font stack
--molan-font-heading Heading font stack
--molan-font-code Code font stack
--molan-radius-s, --molan-radius-m, --molan-radius-l Corner radii
--molan-folder-0 to --molan-folder-6 PARA/LifeOS folder accent colors

Example CSS snippet:

/* .obsidian/snippets/molan-overrides.css */
.theme-light {
  --molan-font-heading: Georgia, serif;
  --molan-folder-3: #4f8582;
}

Enable the snippet from Settings → Appearance → CSS snippets. If another snippet changes Obsidian color variables or pane backgrounds, disable it first when troubleshooting visual conflicts.

Features

  • Full light “rice paper” and dark “night ink” color systems; neither uses pure black or white.
  • Self-contained paper grain and ink-wash scenery. Key artwork is embedded as a Data URI, so it is not loaded from the network and does not depend on a local image path.
  • Native CSS-mask folder glyphs with low-saturation colors for folders beginning with 0 through 6.
  • Styling for editing and reading views, sidebars, tabs, menus, settings, and mobile layouts.
  • Coverage for links, tags, tasks, callouts, tables, code, search, Canvas, Graph, Bases, Calendar, Dataview, and Kanban class names.
  • No external fonts, network requests, telemetry, or tracking code.

Folder color conventions

Folders with these prefixes receive a fine accent rule and a matching folder glyph:

Prefix Meaning Accent
0. or 0 System muted vermilion
1. or 1 Daily muted ochre
2. or 2 Inbox moss green
3. or 3 Projects celadon
4. or 4 Areas landscape blue
5. or 5 Resources blue violet
6. or 6 Archive dusty violet

中文说明

一套为 Obsidian 设计的低饱和水墨主题。它以宣纸白、墨青蓝与雾青绿为主,保留朱砂、赭金、藕紫等少量功能色;重点是长时间写作和阅读时的安静层次,而不是用大面积图案制造“国风”。

安装

  1. 在 Obsidian 打开 设置 → 外观 → 主题 → 管理,搜索并安装 MoLan
  2. 安装后点击 使用 即可启用。
  3. 手动安装时,请将 Release 中的 theme.cssmanifest.json 直接放入 <Vault>/.obsidian/themes/MoLan/

自定义

无需安装 Style Settings 插件。可在 Obsidian 内置外观设置中切换明暗模式;如需微调字体、圆角或目录色,可在 CSS snippet 中覆盖 theme.css 顶部的 --molan-* 变量。若与其他 snippet 出现视觉冲突,请优先停用会改写颜色变量或窗格背景的 snippet。

设计特性

  • 浅色“宣纸”与深色“夜墨”两套完整色阶,均非纯黑白。
  • 水墨画面内嵌于 CSS,不访问外部网络,也不依赖本机图片路径。
  • 目录拥有 CSS mask 文件夹图标,自动适配 0系统 / 0.系统6归档 / 6.归档 的低饱和功能色。
  • 适配编辑模式、阅读视图、侧栏、标签页、菜单、设置页与移动端。

发布前

本仓库已按社区主题的发布结构准备:根目录包含 theme.cssmanifest.jsonversions.json、许可证与 16:9 预览图。发布时应创建与 manifest.json 完全一致的 GitHub Release 标签,并附上 theme.cssmanifest.json

许可与致谢

本主题为独立实现。开发时仅将 Retroma 用作 Obsidian 主题覆盖范围的参考,未复制其 CSS、图片或代码。

本项目采用 MIT License 开源。