コンテンツにスキップ

Zensical

  • in Zensical
  • このページは約1分で読めます

Zensical 0.0.64でブログ機能がリリース

以前からMaterial for MkDocsのリリースページには以下のように「Material for MkDocsは2026年11月5日でサポート終了になるのでZensicalへの移行を検討してください」という趣旨のメッセージが掲載されていました。

Warning

Material for MkDocs is approaching end of life

Material for MkDocs is scheduled to reach end of life on November 5, 2026. Until then, maintenance is limited to critical bug fixes and security updates. After this date, the project will remain available on PyPI and GitHub, but no further maintenance is planned except in exceptional circumstances.

For users looking for a long-term, actively developed successor, we're building Zensical – a next-generation static site generator designed for technical documentation. If you're planning a new documentation project or evaluating your long-term options, we invite you to take a look.

Organizations requiring support beyond this date are welcome to get in touch to discuss available options.

Read the full announcement on our blog

しかし、Zensicalには長らくブログ機能が実装されなかった為、ブログ機能を利用しているユーザはMaterial for MkDocsを利用し続けざるを得ませんでした。ですが、ついに待望のブログ機能を実装したZensical 0.0.64がリリースされました！

リリースノートには以下の記載があります。「MkDocsのブログ機能をそのまま移植した」ようであり、良い意味でも「従来の設定がそのまま利用可能」ですが、新機能も無いようです。とは言え、「ブログ機能の為だけにMkDocsを利用し続ける必要がなくなった」ことは大きく、喜ばしいニュースです！

Many of you have been waiting for this one: Zensical now includes native blog support. As a direct port of the Material for MkDocs blog plugin, it preserves the familiar configuration, metadata, URLs, archives, categories, authors, pagination, and more. We're happy to finally put it into your hands, with more flexible blogging functionality planned for the future.

Antigravity-IDEにZensical Studioをインストールする

VSCodeやAntigravity IDEで利用可能なプラグイン「Zensical Studio」がリリースされました。

Zensical Studioを利用することで「Zensical独自の記法」もエディタ上でハイライトされるようになります。但し、エディタ右上にある「プレビュー」のボタンが表示されず、コマンドパレットからもプレビュー機能が利用できなくなってしまいます。公式ドキュメントには「zensical serveを使ってプレビューできる」と書かれていますが、裏を返すと「エディタ内プレビューは意識的に無効化してある」ということなのかもしれません。

image

  • in Zensical
  • このページは約4分で読めます

Zensicalでコンテンツをインライン表示する

Zensicalでコンテンツをインライン表示する方法をメモしておきます。設定方法は公式サイトのNavigation integration¶で説明されています。このページで説明されている方法では「あらゆるコンテンツをインライン表示できる」わけでは無く、「Admonitionsと文章などのコンテンツをインライン表示する」という点に注意してください。「Admotion」とは、注意書きや情報ボックスなどを表示するための機能です。

  • in MkDocs, Zensical
  • このページは約9分で読めます

「MkDocs + Material for MkDocs」の後継は「Zensical」

Material for MkDocsのバージョン9.7.0のリリースノートには以下の記載があります。

This is the last release of Material for MkDocs that will receive new features. Going forward, the Material for MkDocs team focuses on Zensical, a next-gen static site generator built from first principles. We will provide critical bug fixes and security updates for Material for MkDocs for 12 months at least.

Deepl翻訳

Material for MkDocsの新機能提供は、これが最後のリリースとなります。今後、Material for MkDocsチームは、第一原理に基づいて構築された次世代静的サイトジェネレータであるZensicalに注力します。Material for MkDocsについては、少なくとも12か月間は重大なバグ修正とセキュリティ更新を提供します。

従来は「MkDocsにMaterial for MkDocsテーマをインストールして利用する」という構成でしたが、後継にあたるZensicalは単体で「MkDocsとMaterial for MkDocsテーマ」の機能をカバーするようです。

コマンドでの操作感は「ZensicalとMkDocsで全く同じ」である為、操作にこまることは無いと思いますが、Zensicalの基本的な利用方法をメモしておきます。