Swak

Swak — Refined Business Document Theme for Obsidian

---

Overview / 概要

English

Swak is an executive-level Obsidian theme focused on "Simple is Best" business structural beauty. It delivers disciplined typography and logical visual hierarchy so that strategic proposals, meeting minutes, and knowledge repositories remain distraction-free and instantly comprehensible.

日本語

Swakは、「シンプルイズベスト」に徹底してこだわった、ビジネス特化型の構造美を体現するObsidianテーマです。過剰な装飾を排し、端正なタイポグラフィと明確な視覚的階層によって、戦略提案書、議事録、社内ナレッジを直感的かつ瞬時に理解できるドキュメント環境を提供します。

---

Business Structural Features / ビジネス構造美の特徴

English

• Executive Heading Architecture: Solid deep navy banners (#0B3D63) for H1 chapter shifts, soft-blue filled containers (#E6EFF7) for H2 section boundaries, and distinctive rounded square badges (■) for H3 action points.
• High-Contrast Text Emphasis: Bold statements, italicized parameters, code literals (inline code), and strikethroughs are balanced for immediate scanning without visual fatigue.
• Refined Callouts: Subtle fills and clear borders distinguish supporting information. Tip uses the Lucide lightbulb icon; Danger uses circle-alert.
• Disciplined Business Tables: Engineered specifically for cost comparisons, matrix evaluations, and project timelines with balanced padding and slate-gray headers.
• Structured Lists and Quotes: Bullets and numbers match the body text color. Compact nesting and neutral quote lines keep the spacing balanced around markers and text.
• Reading and Live Preview Alignment: Heading spacing, lists, quotes, callouts, and embedded elements stay closely aligned while switching between reading and editing. Properties use one paragraph of space before the body in both modes; hidden YAML does not add a chapter gap.
• Readable Properties: A subtle card, distinct labels, and body-size values make metadata easy to scan. Long descriptions remain fully visible.
• Chapter Spacing and PDF Pagination: H1 headings following body content use a 64px top gap. In PDF export, the first body H1 does not force a page break; the second and subsequent body H1 headings start a new page. The optional filename title does not count as a body H1.
• Light and Dark Support: Calibrated colors for both appearances.

日本語

• 明瞭な見出し体系（H1・H2・H3）: 重厚なネイビーの帯見出し（H1）、淡青のセクション区分（H2）、角丸スクエアバッジ（H3）により、長文でも論理構造が一目で把握できます。
• 視認性に優れた文字強調: 太字（重要決定事項）、斜体（パラメータ）、インラインコード（DATABASE_URL）、打ち消し線（旧要件）が端正に調和し、必要な情報を迷いなく識別できます。
• 洗練されたコールアウト: 淡い背景と明確な枠線で補足情報を整理。推奨（Tip）はLucideの lightbulb、危険（Danger）は circle-alert を使用します。
• 実務志向の表組み: 比較表や進捗表の可読性を極限まで高めたテーブルスタイリング。
• 整然としたリストと引用: 箇条書きの点・数字を本文色に統一。コンパクトなネストとグレー系の引用線で、記号・線と文字の余白を整えます。
• 閲覧・編集の見え方を統一: リーディングビューとライブプレビューの見出し、リスト、引用、コールアウト、埋め込み要素の余白を近づけています。プロパティから本文までは両モードとも段落1つ分の間隔とし、非表示のYAMLに章間余白を加えません。
• 読みやすいプロパティ: 控えめな背景と枠、強弱をつけた項目名、本文サイズの値で情報を整理します。長い説明文も省略せず表示します。
• 章の区切りとPDF改ページ: 本文からH1へ移る上余白は64px。PDFでは本文の最初のH1で強制改ページせず、2つ目以降のH1で改ページします。ファイル名タイトルは本文のH1として数えません。
• ライト/ダーク両対応: どちらの環境でも一貫した可読性とトーンを維持します。

Properties / プロパティ

English

Properties use the same card in Reading and Live Preview. Labels and values are aligned, descriptions wrap without truncation, and the native property controls remain available. Open the sample.

日本語

プロパティは閲覧・編集とも同じカード表示です。項目名と値を揃え、説明文は省略せず折り返します。Obsidian標準の値編集・項目追加・折りたたみをそのまま使用できます。プロパティのサンプル。

Light / ライト

Dark / ダーク

Chapter Spacing & PDF Export / 章の余白とPDFエクスポート

English

Screen spacing separates chapters without adding manual blank lines. In PDF export, the first body H1 does not force a page break; the second and subsequent body H1 headings start a new page. This rule applies regardless of what appears before the first H1. The optional filename title does not count as a body H1. Use Obsidian's Export to PDF command. Open the meeting sample.

See 1.1.1 release notes.

日本語

画面では手動の空行を増やさず、テーマの余白で章を区切ります。PDFでは本文の最初のH1で強制改ページせず、2つ目以降のH1で改ページします。最初のH1より前に何が書かれているかには依存しません。ファイル名タイトルは本文のH1として数えません。Obsidianの「PDFにエクスポート」を使用してください。会議資料のサンプル。

1.1.1の変更履歴。

Light / ライト

Dark / ダーク

Formatting Examples / 記法例

English

For red bold with highlighting, place *** inside ==. Use [!tip] for recommendations and [!danger] for risks or prohibited actions.

日本語

赤太字＋ハイライトは、== の内側に *** を置きます。推奨事項は [!tip]、危険・禁止事項は [!danger] を使用します。

Callout Colors / コールアウトの配色

English

日本語

---

Complete UI Reference / 全装飾の表示例

English

For Antigravity IDE / VS Code, the separately maintained Swak Markdown extension adds an editable live preview and styles the built-in Markdown preview.

Seven bilingual reference sheets show the theme in Light and Dark appearances. Open the complete sample Markdown.

日本語

Antigravity IDE / VS Codeでは、専用リポジトリで管理するSwak Markdown拡張で、直接編集できるライブプレビューと標準プレビューの両方にSwakの装飾を適用できます。

装飾を7分類に分け、ライト・ダーク両方の実画面を英日併記で掲載しています。全装飾のサンプルMarkdown。

1. Typography / 文字装飾

English

H1–H6, bold, italic, red bold, highlights, strikethroughs, links, footnotes, and horizontal rules.

日本語

H1–H6、太字、斜体、赤太字、ハイライト、打ち消し線、リンク、脚注、水平線。

Light / ライト

Dark / ダーク

2. Structure / 表・リスト・引用

English

Left-, center-, and right-aligned tables, bullets, numbered lists, checkboxes, and three-level quotes.

日本語

表の左・中央・右揃え、箇条書き、番号リスト、チェックボックス、3階層の引用。

Light / ライト

Dark / ダーク

3. Callouts 1 / 情報・要約・推奨

English

Types: note, abstract, info, example, todo, tip, success.

日本語

種類: note, abstract, info, example, todo, tip, success。

Light / ライト

Dark / ダーク

4. Callouts 2 / 注意・危険・参照

English

Types: question, warning, failure, danger, bug, quote.

日本語

種類: question, warning, failure, danger, bug, quote。

Light / ライト

Dark / ダーク

5. Callout Layout / 折りたたみ・ネスト

English

Title-only, initially expanded or collapsed, and three-level nested callouts, plus callouts with tasks.

日本語

本文なし、初期展開・折りたたみ、3階層のネスト、コールアウト内のタスク。

Light / ライト

Dark / ダーク

6. Code & Diagrams / コード・図・数式

English

JavaScript, Mermaid flowcharts, inline math, and block math.

日本語

JavaScript、Mermaidフロー図、インライン数式、ブロック数式。

Light / ライト

Dark / ダーク

7. Details & Embeds / 折りたたみ・埋め込み

English

Collapsed and expanded HTML details, images, and an embedded note sample.

日本語

HTML detailsの開閉、画像、ノートの埋め込みサンプル。

Light / ライト

Dark / ダーク

---

Business Document Samples / 業務文書の表示例

1. English UI Showcase / 英語UIサンプル集

English

An implementation plan with a comparison table, recommendation and danger callouts, task lists, and nested lists and quotes. Open the English sample.

日本語

導入計画の英語サンプルです。比較表、推奨・危険のコールアウト、タスクリスト、階層リスト、引用ネストを確認できます。英語サンプルのMarkdown。

Light / ライト

Dark / ダーク

---

2. Japanese UI Showcase / 日本語UIサンプル集

English

The same document structure in Japanese, including red bold highlighting and compact nesting. Open the Japanese sample.

日本語

同じ構成の日本語サンプルです。赤太字＋ハイライト、リストと引用のネストも確認できます。日本語サンプルのMarkdown。

Light / ライト

Dark / ダーク

3. Live Preview / ライブプレビュー

English

The Japanese sample in Live Preview. Spacing is aligned with Reading view; Markdown markers on the active line and some editor-specific elements can still look different.

日本語

日本語サンプルをライブプレビューで表示した例です。閲覧時に近い余白で編集できます。カーソル行のMarkdown記号や、一部のエディター固有要素には表示差が残ります。

Screenshot Details / 撮影情報

English

Screenshots captured in Obsidian 1.14.5 at 14px body text, using the sample notes and UI reference above.

日本語

上記の業務文書・UIリファレンスをObsidian 1.14.5・本文14pxで表示し、実画面を撮影しています。

---

Installation / インストール方法

Option 1: Community Themes (Recommended) / コミュニティテーマから（推奨）

English

Swak is available in the Obsidian Community directory. Select Add to Obsidian on the listing page, or install it from within Obsidian:

1. Open Settings in Obsidian (Cmd + , or Ctrl + ,).
2. Navigate to Appearance -> Themes -> Community themes.
3. Click Manage, search for Swak, and click Use.

日本語

Obsidian Communityに掲載されています。掲載ページの Add to Obsidian、または次の手順でObsidian内から導入できます。

1. Obsidianの「設定」を開きます（Cmd + , または Ctrl + ,）。
2. 「外観」 -> 「テーマ」 -> 「コミュニティテーマ」へ進みます。
3. 「管理」をクリックし、Swak で検索して「使用」をクリックします。

Option 2: Manual Installation / 手動インストール

English

1. Download theme.css and manifest.json from the Latest Release.
2. Create a folder named Swak under <Your Vault>/.obsidian/themes/.
3. Place theme.css and manifest.json inside <Your Vault>/.obsidian/themes/Swak/.
4. In Obsidian, go to Settings -> Appearance -> Theme, and select Swak.

日本語

1. 最新リリース から theme.css と manifest.json をダウンロードします。
2. 保管庫の .obsidian/themes/ 配下に Swak フォルダを作成します。
3. Swak フォルダ内にダウンロードした2つのファイルを配置します。
4. Obsidianの「設定」 -> 「外観」 -> 「テーマ」から Swak を選択します。

---

About Swak Inc. / 株式会社Swak

English

Swak Inc.

• Web: https://swak.jp
• Business: E-commerce Operations / Digital Marketing / Software Development / AI Solutions / Consulting

日本語

株式会社Swak

• Web: https://swak.jp
• 事業内容: EC運営 / Webマーケティング / システム開発 / AIソリューション / 各種コンサルティング

---

License / ライセンス

English

Licensed under the MIT License.

The embedded square-text icon is from Lucide under the ISC License; its notice is included in theme.css.

日本語

MITライセンスに基づき配布されています。

埋め込みの square-text アイコンはLucideのISCライセンスに基づき使用し、ライセンス表記を theme.css に含めています。