ZennとQiitaの記事をGitHubリポジトリで同時に管理する

Posted at 2025-01-14

はじめに

エンジニア向けの日本語記事共有プラットフォームといえば Qiita や Zenn などが挙げられます。

これまで私は読む側でしか使ってこなかったのですが、最近個人ブログで１日１記事を書く習慣をつけるように頑張っています。続けていく中で「技術記事についてはエンジニアが読んでくれるプラットフォームで公開したい」と思うようになりました。

そこで Qiita を使うか Zenn を使うか悩んだ末、結論として「QiitaもZennも使いたい！」という、なんともよくばりな考えにたどり着きました。

過去に「Zenn / Qiitaに投稿する同じ記事を一元管理するGitHubリポジトリを作りました」という記事を読んだことがあり、その際は「ふーん」くらいにしか思ってなかったのですが、今回どのプラットフォームを使うか迷っていた際にこの記事の存在を思い出し、せっかくなので試してみることにしました。

ちなみに今回は先述の記事で紹介されている方法をもとに C-naokiさんが改良した zenn-archive を使って Qiita と Zenn の記事の一元管理化を試してみます。

こちらのツールついては、C-naokiさんご本人が書かれた Zenn vs Qiitaを終わらせに来たの記事に、事前準備や使い方などの手順が詳細に書かれているのでそちらを参考にしてみてください。

この記事では省略しますが、

など類似ツールはいくつかありましたが、今回は zenn-archive を採用しました。

どのツールも大まかな流れとしては

ということをやっています。

採用に至った基準や、実際に使用してみた感想、そのほか詰まったところなどは、個人ブログの「ZennとQiitaの記事をGitHubリポジトリで一括管理する」の記事に書いてありますので、よければこちらも読んでくださると嬉しいです。

実際にツールを使用し、Zenn と Qiita の両方に記事が投稿されるか確認しましたが、どちらも問題なく投稿されたことが確認できたので、今後はこちらのツールを活用し技術記事を公開していきたいなと思います。下にテスト用の記事を貼っておきます。

もちろん、今あなたが読んでいるこの記事も、zenn-archive を使って同時投稿しています。画像添付や注釈表記などにも対応しているのですが、それはまた別の記事で試してみたいと思います。

というわけで、Zenn と Qiita の記事を、GitHubリポジトリで一元管理する方法の紹介でした。