Qiita CLIでできること、できないこと

はじめに

はじめまして。Qiita Advent Calendar 2023の完走賞を狙ってるにわのわです。
Advent Calendarを走るにあたってローカルで記事の管理をしたいと思い導入しました。
手ごたえとしてはかなりおすすめです。

参考

完走賞
Qiita記事に1人で25記事投稿しきった方∞名を表彰します。（複数のカレンダーで計25記事の投稿も対象）

インストール

公式のインストールがしっかり書かれているのでそちらを参照してください。
自分のエディタで記事投稿ができる、Qiita CLIの使い方 #Qiita - Qiita

できること(うれしいこと)

普段はこちらでhugoを使ったブログを書いているので、そちらとの機能の比較をしていきます。

• ホットリロード機能
  markdownファイルを保存すると自動でブラウザも更新してくれます。
  無いと死んじゃう。
• サイドバーがとてもよい
  非常に良くないですか？
  良いですね。
  
• ローカルでもQiitaの記法で表示される。
  リンクカードなど、md標準でない機能もきちんと動いてくれます。感謝。
  
• 改行が改行だけでよい
  hugo、というかmdだと改行するときにスペース2つ入れないといけないのですが、Qiita CLIだと改行だけでよいです。
  感情の赴くままにキーボードを叩く勢なので非常に助かります。日本語入力の時、特に。

できないこと(ちょっと辛いこと)

• Qiita CLIの機能説明が公式説明で見つけられない
  あったら申し訳ないのですが、ありますか？
  インストールについてはめちゃめちゃ心遣いを感じるのに
  こんな機能があるぜ！という説明が見つけられなかったので、最初の一歩に抵抗を感じました。
• テンプレートがない
  npx qiita new (記事のファイルのベース名)で記事を作成すると、デフォルトのテンプレートが吐かれるのですが、
  これを自分好みのものに変えられないです。
  例えばprivate: trueにするとか、やりたいことはあるのですが...
• ページバンドルがない
  hugoにはpagebundleという機能があります。
  これとPaste ImageというVSCodeの拡張機能を使うと、ctrl+Vで画像を張り付けることができ、
  画像の管理がしあわせに行うことができます。
  要するにqiita CLIで画像を貼り付けようとするとちょっと辛いです。
  Page bundles | Hugo

Paste Image - Visual Studio Marketplace

• リンクカードの表示がおかしくなる時がある
  現状、再現2回。ctrl+S連打マンだとなるかも？

• updated_atが毎度更新される
  限定共有記事限定？
  特に差分がないはずなのに更新される。
  

• タグに空白が含まれるとGHAで落ちる
  これはQiitaにわかの自分が悪い部分もありますが、落ちてるときのログがこれ。
  

おまけ

こんな感じのtasks.jsonを書いておくとvscodeでQiita CLI用のプロジェクトを開くだけでプレビューページが表示されて幸せになれます。

tasks.json

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Qiita Preview",
            "type": "shell",
            "command": "bash -c \"npx qiita preview\"",
            "presentation": {
                "reveal": "always",
                "panel": "new"
            },
            "runOptions": {
                "runOn": "folderOpen"
            }
        }
    ]
}

さいごに

以上。Qiita CLIに触れてみた感想でした。
マジで簡単に環境作れるのでおすすめです。