1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

はてなブログと併用するためにQiita CLIを導入して環境を整える話。

1
Last updated at Posted at 2026-11-15

はじめに

はてなブログとの併用を決めた背景には、技術系のアウトプット先として Qiita を追加するという判断があります。
これまでのはてなブログ運用(はてな記法 + post_to_hatena.py)と併用する形で、より多様な技術情報を発信するための選択肢として、Qiita CLI を導入しました。

Qiita API v2 直接利用 vs @qiita/qiita-cli の比較表

特徴 Qiita API v2 を直接利用 @qiita/qiita-cli
ローカルプレビュー ❌ ✅
frontmatter での id 自動管理 ❌ ✅
ローカル画像の自動アップロード ❌ ❌
非対話での認証対応 ❌ ✅
開発効率 低め 高め
記事の公開状態 private: true が必須 private: true が必須

併用ワークフロー全体図

セットアップ手順とディレクトリ構成

Qiita CLI を導入するには、以下の手順を踏みます。

  1. npm install @qiita/qiita-cli --save-dev により、Qiita CLI を開発用依存ライブラリとしてインストールします。
  2. npx qiita init で、ディレクトリ構成(public/, qiita.config.json, .github/ 等)を初期化します。

このとき、public/ ディレクトリ以下に記事を配置し、qiita.config.json に設定を記載します。

導入時にハマったポイント3つ

1. 非対話での credentials.json スキーマと chmod 600

非対話環境で認証を通す際には、~/.config/qiita-cli/credentials.json の形式を揃える必要があります。
default と credentials 配列の形式を確認し、パーミッションを 600 に設定する必要があります。

2. v0.5.0 以降の frontmatter 必須項目と private: true

v0.5.0 以降、frontmatter に id と private が必須項目として追加されています。
private: true が明記されていないと、記事は全体公開扱いになるため、注意が必要です。

3. ローカル画像非対応への対処

Qiita CLI はローカル画像の自動アップロードに対応していません。
プレビュー画面や外部URLを使う運用にしています。

まとめ

これで、ローカル執筆→プレビュー確認→限定共有投稿のサイクルが回り始めました。
はてなブログとの併用もスムーズにできるようになりました。

じゃあね。

カルディアと開発環境

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?