zhongwei/gh-shin902-shi-marketplace-marp-slide

Fork 0

Files

Zhongwei Li 5e6eb99dc0 Initial commit

2025-11-30 08:56:44 +08:00

5.9 KiB

Raw Blame History

Marp テーマCSS作成ガイド

Marpit公式のテーマCSS仕様に基づく、カスタムテーマの作成方法。

公式ドキュメント: https://marpit.marp.app/theme-css

テーマの基本構造

@themeメタデータ（必須）

テーマCSSには@themeメタデータが必要：

/* @theme theme-name */

このメタデータがないと、テーマとして認識されません。

基本的なテーマCSS例

/* @theme my-theme */

section {
  background-color: #fff;
  color: #333;
  font-size: 24px;
  padding: 60px;
}

h1 {
  color: #1e40af;
  font-size: 48px;
}

h2 {
  color: #3b82f6;
  font-size: 36px;
}

HTML構造

Marpが生成するHTML構造：

<section>
  <h1>スライドタイトル</h1>
  <p>コンテンツ</p>
</section>

各スライドは<section>要素として生成されます。

スライドサイズ

デフォルトサイズ

section {
  width: 1280px;
  height: 720px;
}

16:9比率（1280x720）がデフォルト。

カスタムサイズの定義

/* @theme my-theme */
/* @size 4:3 960px 720px */

section {
  width: 960px;
  height: 720px;
}

@sizeメタデータでカスタムサイズを定義できます。

ページネーション

ページ番号のスタイリング：

section::after {
  content: attr(data-marpit-pagination) ' / ' attr(data-marpit-pagination-total);
  position: absolute;
  right: 30px;
  bottom: 20px;
  font-size: 16px;
  color: #666;
}

利用可能な属性:

data-marpit-pagination - 現在のページ番号
data-marpit-pagination-total - 総ページ数

ヘッダーとフッター

ヘッダー

header {
  position: absolute;
  top: 30px;
  left: 60px;
  right: 60px;
  font-size: 18px;
  color: #666;
}

フッター

footer {
  position: absolute;
  bottom: 30px;
  left: 60px;
  right: 60px;
  font-size: 18px;
  color: #666;
}

テーマの拡張と継承

@importでの読み込み

/* @theme my-extended-theme */

@import 'default';

section {
  background-color: #f0f0f0;
}

既存のテーマを拡張できます。

@import-themeで名前付きテーマを継承

/* @theme my-theme */

@import-theme 'default';

h1 {
  color: red;
}

@import-themeを使用すると、テーマ名で読み込めます。

クラスベースのバリエーション

leadクラス（タイトルスライド）

section.lead {
  display: flex;
  flex-direction: column;
  justify-content: center;
  align-items: center;
  text-align: center;
}

section.lead h1 {
  font-size: 64px;
}

invertクラス（反転配色）

section.invert {
  background-color: #000;
  color: #fff;
}

section.invert h1,
section.invert h2 {
  color: #fff;
}

Scoped Style（スライド固有のスタイル）

Markdown内で<style scoped>を使用：

<style scoped>
section {
  background-color: #e3f2fd;
}
</style>

# このスライドだけ青い背景

背景画像のスタイリング

背景画像は自動的に処理されますが、CSSで調整可能：

section[data-marpit-background-image] {
  background-size: cover;
  background-position: center;
}

数式のスタイリング（Marp Core）

.katex {
  font-size: 1.2em;
}

.katex-display {
  margin: 1em 0;
}

リストのスタイリング

ul, ol {
  margin: 0.5em 0;
  padding-left: 1.5em;
}

li {
  margin: 0.3em 0;
}

li::marker {
  color: #3b82f6;
}

テーブルのスタイリング

table {
  border-collapse: collapse;
  width: 100%;
  margin: 1em 0;
}

th, td {
  border: 1px solid #ddd;
  padding: 0.5em 1em;
  text-align: left;
}

th {
  background-color: #f0f0f0;
  font-weight: bold;
}

コードブロックのスタイリング

pre {
  background-color: #f5f5f5;
  border-radius: 4px;
  padding: 1em;
  overflow-x: auto;
}

code {
  font-family: 'Courier New', monospace;
  font-size: 0.9em;
}

pre code {
  background-color: transparent;
  padding: 0;
}

レスポンシブ対応

@media screen and (max-width: 1280px) {
  section {
    font-size: 20px;
  }
  
  h1 {
    font-size: 40px;
  }
}

実践的なテーマ例

ミニマルテーマ

/* @theme minimal */

section {
  background-color: #ffffff;
  color: #333333;
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
  font-size: 24px;
  padding: 80px;
}

h1, h2, h3 {
  font-weight: 300;
  color: #000000;
}

h1 {
  font-size: 60px;
  margin-bottom: 0.5em;
}

h2 {
  font-size: 40px;
  margin-bottom: 0.5em;
}

ダークテーマ

/* @theme dark */

section {
  background-color: #1a1a1a;
  color: #e0e0e0;
  font-size: 22px;
  padding: 60px;
}

h1, h2, h3 {
  color: #61dafb;
}

a {
  color: #61dafb;
}

code {
  background-color: #2d2d2d;
  color: #61dafb;
}

Markdown内でのスタイル埋め込み

---
marp: true
---

<style>
section {
  background-color: #f8f8f4;
  font-family: 'Noto Sans JP', sans-serif;
}

h1 {
  color: #4f86c6;
}
</style>

# スライド

この方法でテーマを使わずにカスタムスタイルを適用できます。

ベストプラクティス

コントラストを確保: 背景とテキストの色のコントラスト比を4.5:1以上に
適切なフォントサイズ: 本文22-24px、タイトル40-60px程度
余白を十分に: パディング60px以上推奨
フォールバックフォント: Web Fontが読み込めない場合のシステムフォントを指定
印刷対応: @media printで印刷用スタイルも定義

公式リファレンス

詳細は公式ドキュメントを参照：

Theme CSS: https://marpit.marp.app/theme-css
Marpit API: https://marpit-api.marp.app/
公式テーマ実装: https://github.com/marp-team/marp-core/tree/main/themes

5.9 KiB Raw Blame History Unescape Escape