Initial commit: LLM Wiki with raw and wiki folders only

This commit is contained in:
2026-04-07 21:10:43 +08:00
commit 80bc593b36
25 changed files with 2996 additions and 0 deletions

View File

@@ -0,0 +1,173 @@
---
categories:
- "[[Marp]]"
tags:
- marp
- theme
- css
- styling
created: 2026-04-07
source: "[[marp-guide]]"
type: reference
aliases:
- Marp 主题
- Marp 样式
---
# Marp 主题与样式
> Marp 的内容与样式完全分离——Markdown 管内容CSS 主题管外观。
## 三个内置主题
| 主题 | 风格 | 适用场景 |
|------|------|----------|
| `default` | 经典白底、蓝灰色调、左对齐 | 通用、商务 |
| `uncover` | 极简、居中布局、现代感 | 技术分享、轻松场合 |
| `gaia` | 彩色、大胆、左对齐 | 创意、教育 |
使用方式:
```markdown
---
marp: "true"
theme: uncover
---
```
> [!tip] 初学建议从 `uncover` 开始,它对 Markdown 的默认渲染效果最好。
## 用 style 指令微调
不想写独立 CSS 文件,可以用 `style` 全局指令内联修改:
```markdown
---
theme: default
style: |
section {
background-color: #f0f0f0;
}
h1 {
color: #0066cc;
border-bottom: 2px solid #0066cc;
}
---
```
> [!note] `style` 指令比 `<style>` 标签更好——不会在其他 Markdown 编辑器里显示异常。
## 用 class 指令切换布局
在主题 CSS 中定义不同的 section 类:
```css
section.lead h1 {
text-align: center;
font-size: 2.5em;
}
section.dark {
background-color: #1a1a2e;
color: #e0e0e0;
}
```
然后在 Markdown 中使用:
```markdown
<!-- _class: lead -->
# 居中大标题
---
<!-- _class: dark -->
# 深色页面
```
## 自定义主题
### 在 Obsidian Marp 插件中
1.`Templates/MarpTheme/` 目录中放入 CSS 文件
```
<vault>/
└── Templates/
└── MarpTheme/
├── beamer.css
└── gradient.css
```
> [!note] Obsidian Marp 插件设置中 Theme Folder Location 应配置为 `Templates/MarpTheme`。
3. 在 Markdown 中引用:
```markdown
---
marp: "true"
theme: beamer
---
```
> [!warning] 添加新 CSS 后需要**重启 Obsidian**。
### CSS 主题基本结构
```css
/* @theme my-custom-theme */
@import 'default';
section {
font-family: 'Noto Sans SC', sans-serif;
background: #ffffff;
color: #333333;
}
h1 {
color: #2c3e50;
border-left: 4px solid #3498db;
padding-left: 0.5em;
}
h2 {
color: #34495e;
}
code {
background: #ecf0f1;
padding: 2px 6px;
border-radius: 3px;
}
```
> `@import 'default'` 继承内置主题,只覆盖需要改的部分。
## 背景技巧
### 纯色背景
```markdown
<!-- _backgroundColor: #1a1a2e -->
<!-- _color: #e0e0e0 -->
```
### 渐变背景
```markdown
<!-- backgroundImage: linear-gradient(to bottom, #667eea, #764ba2) -->
```
### 图片背景
```markdown
![bg cover](path/to/image.jpg)
```
## 来源
- [[marp-guide]] — 原始资料
- [[Marp]] — Marp 概念页
- [[Marp 指令语法]] — 指令参考