biliotech

＜目次＞

なぜNotionで書くのか仕組みの全体像データベースのプロパティ設計埋め込みの工夫まとめ

「ブログを始めたいけど、記事を書く以外の作業が面倒そう」と感じていませんか？

実はこのブログ（biliotech）は、Notionに書いた記事が、そのままWebサイトとして公開される仕組みで運営しています。

今回は、その仕組みの全体像と、Notion側でどんなことを設定しているのかを紹介します。

いちばんの理由は、普段使っているNotionで、そのまま記事を書けるからです。

「書く場所」と「管理する場所」が同じなので、ブログのための作業を最小限にできるのが大きなメリットです。

このブログは、Notionをデータの置き場所（CMS）として使い、Astroというフレームワークで静的なWebサイトを生成しています。

ベースにしているのは、オープンソースの「astro-notion-blog」で、そこに独自のカスタマイズを加えています。

全体の流れは次のとおりです。

ここでポイントになるのが、記事はビルドしたときに取得されるという点です。

Notionで記事を書いただけではサイトは更新されず、再ビルド（再デプロイ）したタイミングで反映されます。

NotionのAPIキーやデータベースIDは、コードには書かず、Cloudflare Pagesの環境変数として設定しています。

また、記事数が増えるとNotion APIの呼び出し回数の上限（レート制限）にかかることがあるため、上限にかかってもビルドが止まりにくいよう、再試行する処理を入れています。

記事を管理しているNotionのデータベースには、次のようなプロパティを用意しています。

サイトに表示されるのは、Publishedにチェックが入っていて、Dateがビルド時点以前の記事だけです。

そのため、チェックを外しておけば下書きとして置いておけますし、Dateを未来の日付にしておけば、その日以降のビルドで公開されるようにもできます。

記事の中で商品や他の記事を紹介するときのために、埋め込みの表示もカスタマイズしています。

とくに最後のコードブロックの仕組みは、Notionには「HTMLをそのまま貼る」機能がないため、コードブロックを目印にしてHTMLとして表示するように工夫したものです。

たとえば、こちらの記事では、メンバーの書籍をAmazonのリンクで紹介しています。

※2026年10月追記：メンバーの藤堂カイがGo言語の書籍『Go言語アンチパターン42問』も出版しました。

今回は、Notionで書いた記事がそのままブログとして公開される仕組みを紹介しました。

「書くことに集中できるブログ」を作りたい人には、Notion × 静的サイトという組み合わせはとてもおすすめです。

興味のある方は、まずはNotionで記事用のデータベースを作るところから始めてみてくださいね。

メンバーのSNSアカウントはこちら

◆かいと：IT担当
X(旧Twitter)
Instagram

NotionでブログをSSG運用する仕組み：Notionに書くだけで記事が公開されるまで