はじめに
Obsidian で書いたノートを「PDF にエクスポート」すると、こんなことが起きます。
- 見出しだけがページの一番下に取り残され、本文は次のページから始まる
- 段落や表が、ページの境目で上下に別れる
これに違和感を覚えた人は次に、改ページタグを手動で挟むようになります。
<div style="page-break-after: always;"></div>
しかし、これは文章を直すたびに位置がずれるので、
文章を更新するたびに改ページタグを付けたり外したり、時間を浪費してしまいます。
この記事では、CSS スニペットを 1 つ入れるだけで、
改ページ位置をいい感じに自動で決めてもらう方法を紹介します。
テーマや他のプラグインには依存しません。
結論:このCSSを入れるだけです
/*
* page-break-auto.css
* Obsidian の PDF 出力で、改ページ位置を自動で整える CSS スニペット
*
* 効くのは PDF 出力(印刷)のときだけ。編集画面・閲覧画面の見た目は変わらない。
* Obsidian 標準の「PDF にエクスポート」と、Better Export PDF プラグインの両方で使える。
* テーマや他のスニペットに依存しない。
*
* ルール
* 1. 改ページは見出し(H1〜H4)の直前でだけ起こす。本文の途中では切らない
* 2. 見出しだけがページの最下部に取り残されないようにする
* 3. 段落・箇条書き・表・コードブロック・引用・画像・コールアウトを途中で切らない
* 4. 表がページをまたぐときは、次のページにも見出し行を出す
* 5. H2・H3 がページの下の方(--heading-keep の範囲)に来たら、見出しごと次のページへ送る
*
* 手動の改ページ <div style="page-break-after: always;"></div> もそのまま併用できる。
* このスニペットをオフにすれば元の動作に戻る。
*/
@media print {
/* 5. の「下の方」の範囲。A4縦なら 55mm(本文領域の約2割)がちょうどよい。
用紙や余白を変えたときは、ここを調整する */
.print .markdown-preview-view {
--heading-keep: 55mm;
}
/* 1. 見出しを含まないブロックの直前では改ページしない(=改ページは見出しの直前だけ)。
Obsidian は見出しや段落を div で包んで並べるので、
「直下の要素」ではなく「中に見出しを含むかどうか」で判定する */
.print .markdown-preview-view > div:not(:has(h1, h2, h3, h4)) {
break-before: avoid;
}
/* 2. 見出しの直後では改ページしない(見出しと、それを包む div の両方に指定する) */
.print .markdown-preview-view :is(h1, h2, h3, h4, h5, h6),
.print .markdown-preview-view div:has(> :is(h1, h2, h3, h4, h5, h6)) {
break-after: avoid;
}
/* 3. ブロックの途中では切らない。ページの残りに入らないブロックは、丸ごと次のページへ送る。
1ページに収まらない大きさのものは、ブラウザがやむを得ず途中で切る。
Better Export PDF 自身の `table { break-inside: auto }` より詳細度を上げて上書きしている */
.print .markdown-preview-view :is(p, ul, ol, table, tr, pre, blockquote, img, .callout) {
break-inside: avoid;
}
/* 4. 表がページをまたいだら、次のページにも見出し行を出す */
.print .markdown-preview-view thead {
display: table-header-group;
}
/* 5. 安全マージン。
H2・H3 を包む div の末尾に、高さ --heading-keep の見えない箱を置き、
同じ高さの負のマージンで後ろの本文を引き戻す(見た目の位置は変わらない)。
この div は途中で切れない指定なので、ページの残りが「見出し+箱」より少ないと、
見出しごと次のページへ送られる */
.print .markdown-preview-view div:has(> :is(h2, h3)) {
break-inside: avoid;
}
.print .markdown-preview-view div:has(> :is(h2, h3))::after {
content: "";
display: block;
height: var(--heading-keep);
margin-bottom: calc(-1 * var(--heading-keep));
pointer-events: none;
}
/* オプション:frontmatter に cssclasses: [page-break-h2] を付けたノートだけ、
H2 を必ず新しいページから始める(最初のページの先頭にある H2 では空白ページはできない) */
.print .page-break-h2 div:has(> h2) {
break-before: page;
}
}
導入手順
- 上の CSS を
page-break-auto.cssという名前で保存する - Obsidian の「設定 → 外観 → CSS スニペット」の右にあるフォルダアイコンを押し、開いたフォルダ(
<Vault>/.obsidian/snippets)にファイルを置く - 再読み込みボタンを押し、一覧に出た
page-break-autoをオンにする - いつもどおり「PDF にエクスポート」する
編集画面の見た目は一切変わりません。
効くのは PDF に出力するときだけです。
やめたくなったらスニペットをオフにすれば元に戻ります。
PDF出力には「Better Export PDF」を使用することをオススメしますが、
なくても標準の「PDFにエクスポート」でも使用可能です。
このCSSがやっていること
ルールは 5 つだけです。
| # | ルール | ねらい |
|---|---|---|
| 1 | 改ページは見出し(H1〜H4)の直前でだけ起こす | 話の途中でページが変わらない |
| 2 | 見出しの直後では改ページしない | 見出しだけが取り残されない |
| 3 | 段落・リスト・表・コード・引用・画像・コールアウトを途中で切らない | ブロックが泣き別れにならない |
| 4 | ページをまたいだ表は、次のページにも見出し行を出す | 2 ページ目以降の表も読める |
| 5 | H2・H3 がページ下部 55mm 以内に来たら、見出しごと次ページへ | 見出し+本文 1 行だけ、のような中途半端な状態を防ぐ |
こだわりポイント
1. 見出しそのものではなく「見出しを包む div」で判定する
改ページの CSS というと、まず思いつくのは次のような書き方です。
h2 { break-after: avoid; }
ところが Obsidian の印刷用の HTML は、
見出しも段落も 1 つずつ div に包まれて横並びになっています。
<div class="markdown-preview-view">
<div><h2>見出し</h2></div>
<div><p>本文…</p></div>
<div><p>本文…</p></div>
</div>
実際に改ページが起きるのは、この div と div の間 です。
そのため、見出し要素にだけ指定しても、期待どおりに効かないことがあります。
そこで :has() を使い、「中に見出しを持っている div」そのものに指定しています。
.print .markdown-preview-view div:has(> :is(h1, h2, h3, h4, h5, h6)) {
break-after: avoid;
}
Obsidian は Chromium ベースのアプリなので、:has() がそのまま使えます。
2. 「どこで切るか」ではなく「どこで切らないか」を書く
「見出しの前で改ページする」と書くと、
すべての見出しで改ページが起きて、
スッカスカの PDF ができあがります。
このCSSでは発想を逆にして、
見出しを含まないブロックの直前では切らないと指定しています。
.print .markdown-preview-view > div:not(:has(h1, h2, h3, h4)) {
break-before: avoid;
}
こうすると、ブラウザが改ページしてよい場所は「見出しの直前」だけになります。
ページに収まる限りは詰めて流し込み、
収まらなくなったら直前の見出しの位置まで戻って改ページしてくれます。
avoid は「できれば避けて」という意味の指定です。
そのため、1 ページに入りきらない長いセクションでは、
ブラウザがちゃんと途中で切ってくれます。
永遠に改ページできなくなる心配はありません。
3. 見えない箱とネガティブマージンで「安全マージン」を作る
break-after: avoid だけでは、
「見出し+本文 1 行」がページの最下部に残ることがあります。
ルール違反ではないのですが、読む側からするとほぼ
「見出しだけ取り残された」状態です。
かといって、見出しの下に余白を入れると
見た目が変わってしまいます。そこで次のようにしました。
.print .markdown-preview-view div:has(> :is(h2, h3)) {
break-inside: avoid;
}
.print .markdown-preview-view div:has(> :is(h2, h3))::after {
content: "";
display: block;
height: var(--heading-keep); /* 見えない箱(55mm)を置き */
margin-bottom: calc(-1 * var(--heading-keep)); /* 同じだけ後ろを引き戻す */
}
- 見出しを包む div の末尾に、高さ 55mm の見えない箱を足します
- これぐらいの高さが一番ちょうどよく感じたので
- 同じ高さのネガティブマージンで、後ろの本文を元の位置まで引き戻します。
- 見た目の位置は 1px も変わりません
- この div は
break-inside: avoid(途中で切らない)なので、ブラウザは「見出し+55mm の箱」が丸ごと入る場所を探します
結果として、ページの残りが 55mm を切った位置にある H2・H3 は、自動で次のページの先頭に送られます。
レイアウト上の高さだけを借りて、見た目には何も足さないのがポイントです。
4. 表の見出し行を次のページにも出す
.print .markdown-preview-view thead {
display: table-header-group;
}
Chromium は既定でも thead を繰り返してくれますが、
テーマ側で thead の display が変えられていると繰り返しが止まります。
明示しておくことで、テーマに左右されないようにしています。
5. 既存の運用を壊さない
- すべて
@media printの中に書いているので、編集画面・閲覧画面には影響しません - 改ページタグ
<div style="page-break-after: always;"></div>は強制改ページなので、avoidより優先されます。今までの手動改ページはそのまま効きます - Better Export PDF プラグインは自前で
table { break-inside: auto }を指定していますが、こちらは詳細度の高いセレクタで書いているため上書きできます
カスタマイズ
安全マージンの高さを変える
A4 縦・標準余白で、本文領域の約 2 割にあたる 55mm を初期値にしています。
用紙サイズや余白を変えた場合、
または「もっと早めに送りたい/ギリギリまで詰めたい」場合は、ここを調整してください。
.print .markdown-preview-view {
--heading-keep: 40mm;
}
H4 も安全マージンの対象にする
:is(h2, h3) の 2 か所に h4 を足します。
.print .markdown-preview-view div:has(> :is(h2, h3, h4)) { break-inside: avoid; }
.print .markdown-preview-view div:has(> :is(h2, h3, h4))::after { /* 中身は同じ */ }
H2 ごとに必ず改ページしたいノートだけ
frontmatter に cssclasses を書いたノートだけ、
H2 を必ず新しいページから始めます。章立てのある資料などに便利です。
---
cssclasses:
- page-break-h2
---
特定の見出しだけ改ページ対象から外す
Obsidian の見出しには data-heading 属性に見出しの文字列が入っています。
たとえば「目次」の H2 だけ改ページしないなら、次のように書けます。
.print .page-break-h2 div:has(> h2[data-heading="目次"]) {
break-before: auto;
}
制約・注意点
便利ですが、万能ではありません。
以下を理解したうえで使ってください。
-
1 ページに収まらないものは途中で切れます。
- 1 ページを超えるセクション・表・画像・コードブロックは、ブラウザがやむを得ず途中で改ページします
-
1 ページを超える表は、見出しごと次のページの先頭から始まります。
- 表を途中で切らない指定のため、直前のページの下部が空白になります
-
ページの下に余白ができます。
- セクションを丸ごと次のページに送るので、ページによっては下部がそれなりに空きます。「余白より読みやすさ」を優先した設計です
-
Obsidian の内部 HTML 構造に依存しています。
-
.print .markdown-preview-view > divという構造が Obsidian のアップデートで変わった場合は、効かなくなる可能性があります
-
-
:has()を使っています。- Obsidian(Chromium)では問題ありませんが、このCSSを他のブラウザ環境へ流用する場合は対応状況を確認してください
-
テーマの印刷用 CSS と競合する可能性があります。
- テーマ側が
break-*を!importantで指定している場合は、そちらが優先されます
- テーマ側が
-
画面表示には効きません。
- あくまで PDF 出力(印刷)用です
まとめ
- Obsidian の PDF 出力の改ページは、CSS スニペット 1 つでかなり賢くできる
- ポイントは「見出しを包む div を
:has()で捕まえる」ことと、「切ってよい場所を見出しの直前だけに絞る」こと - 見えない箱+負のマージンで、見た目を変えずに「ページ下部の見出しは次ページへ」を実現できる
手で改ページを入れては直す作業から解放されたい方は、ぜひ試してみてください。