{"id":13475321,"url":"https://github.com/increments/qiita-cli","last_synced_at":"2025-06-20T10:15:29.005Z","repository":{"id":177478372,"uuid":"660429098","full_name":"increments/qiita-cli","owner":"increments","description":"Qiita CLI とは、手元の環境で記事の執筆・プレビュー・投稿ができるツールです。","archived":false,"fork":false,"pushed_at":"2025-06-04T06:09:00.000Z","size":1495,"stargazers_count":352,"open_issues_count":3,"forks_count":20,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-06-04T13:11:34.316Z","etag":null,"topics":["qiita"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@qiita/qiita-cli","language":"TypeScript","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/increments.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-06-30T01:54:38.000Z","updated_at":"2025-06-04T06:09:00.000Z","dependencies_parsed_at":null,"dependency_job_id":"3e7fbc40-9d7a-4fda-902d-182dc06a76e1","html_url":"https://github.com/increments/qiita-cli","commit_stats":null,"previous_names":["increments/qiita-cli"],"tags_count":23,"template":false,"template_full_name":null,"purl":"pkg:github/increments/qiita-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/increments%2Fqiita-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/increments%2Fqiita-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/increments%2Fqiita-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/increments%2Fqiita-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/increments","download_url":"https://codeload.github.com/increments/qiita-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/increments%2Fqiita-cli/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260924522,"owners_count":23083526,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["qiita"],"created_at":"2024-07-31T16:01:19.388Z","updated_at":"2025-06-20T10:15:23.986Z","avatar_url":"https://github.com/increments.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"![Qiita CLI](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/88/92b6e4ce-4803-b06e-2d56-e7a9507c612f.png)\n\n# Qiita CLI、Qiita Preview へようこそ！\n\nQiita CLI とは、手元の環境で記事の執筆・プレビュー・投稿ができるツールです。\nQiita CLI を使うことで、普段お使いのエディタなどを使って記事の執筆・投稿がしやすくなります。\n\n## ご利用の前に\n\nQiita CLI、Qiita Preview を利用されたら、[利用規約](https://qiita.com/terms)、[プライバシーポリシー](https://qiita.com/privacy)に同意したものとみなします。\n\nこちらの記事リンクもご覧ください\n\n- [コミュニティガイドライン](https://help.qiita.com/ja/articles/qiita-community-guideline)\n- [良い記事を書くためのガイドライン](https://help.qiita.com/ja/articles/qiita-article-guideline)\n- [Markdown 記法 チートシート](https://qiita.com/Qiita/items/c686397e4a0f4f11683d)\n\n#### ⭐ スターのお願い\n\n少しでも興味が湧いたり、実際に使用してみてQiita CLIが便利だと感じたら、ぜひGitHubリポジトリにスターをつけていただけると嬉しいです。\nスターをいただけると、開発のモチベーションが上がり、さらに良いツールをみなさんにお届けする力になります。\n\n#### 📝 記事投稿のお願い\n\nQiita CLIを使って記事が書けたら、ぜひQiitaに投稿してみてください。\n投稿された記事は、多くの人々に役立ち、知識が共有されることに繋がります。\nどんな些細な内容でも大丈夫ですので、ぜひ気軽にご投稿ください🙇‍♂️\n\n[Qiita CLIに関する記事](https://qiita.com/search?sort=created\u0026q=%22Qiita+CLI%22)\n\n#### 👉🏻 ご質問・フィードバックについて\n\nより多くのフィードバックが集まることで、みなさんのお役に立てる機能をどんどん追加することができます。\n\n- よくあるお問い合わせ等を記載しております → [FAQ](#FAQ)\n- 不具合やご意見などございましたら[Qiita Discussions](https://github.com/increments/qiita-discussions/discussions)へご投稿ください。\n\n## Qiita CLI の導入方法について\n\n### 1. 事前準備\n\nQiita CLI を使うには `Node.js 18.18.0` 以上が必要です。  \nNode.js をはじめて使う場合はインストールする必要があります。\n\n### 2. Qiita CLI をインストールする\n\nQiita のコンテンツを管理したいディレクトリで、以下のコマンドを実行します。\n\n```console\nnpm install @qiita/qiita-cli --save-dev\n```\n\n以下のコマンドでバージョンが表示されればインストール完了です。\n\n```console\nnpx qiita version\n```\n\n### 3. Qiita CLI をアップデートする\n\nQiita CLI をアップデートする場合は以下のコマンドを実行します。\n\n```console\nnpm install @qiita/qiita-cli@latest\n```\n\n## Qiita CLI のセットアップ方法について\n\n### init コマンドを実行する\n\n以下のコマンドを実行することで、\n\n- .gitignore\n- GitHub Actions のワークフローファイル\n  - 「GitHub で記事を管理する」の項目を参照\n- ユーザー設定ファイル（qiita.config.json）\n  - 「ユーザー設定ファイルについて」の項目を参照\n\nが生成されます。\n\n```console\nnpx qiita init\n```\n\n### Qiita のトークンを発行する\n\n以下の流れでトークンを発行してください。\n\n- [https://qiita.com/settings/tokens/new](https://qiita.com/settings/tokens/new?read_qiita=1\u0026write_qiita=1\u0026description=qiita-cli) へログインした状態でアクセスします。\n  - トークンの権限には「read_qiita」と「write_qiita」を設定します。\n\n発行したトークンは`Qiita CLIのログイン`、`GitHubで記事を管理する`で利用します。\n\n### Qiita CLI のログイン\n\n以下のコマンドより発行したトークンの登録を行います。\n\n```console\nnpx qiita login\n```\n\n```console\n発行したトークンを入力: トークンを入力しEnterキーを押す\nHi ユーザー名!\n```\n\nトークンを登録することで、Qiita のアカウントと紐付けがされ、記事の取得や投稿、更新が行えるようになります。\n\n## Qiita Preview の起動（プレビュー画面の表示）\n\n本文の執筆は、ブラウザでプレビューしながら確認できます。  \nブラウザでプレビューするためには以下のコマンドを実行します。コマンド実行時に、Qiita に投稿している記事がダウンロードされます。\n\n```console\nnpx qiita preview\n```\n\nコマンド実行すると、Qiita Preview(プレビュー画面)にアクセスすることが可能になります。  \nプレビュー画面のデフォルトの URL は http://localhost:8888 です。\n\n### 記事ファイルの配置について\n\n1 つの記事の内容は、1 つの markdown ファイル（◯◯.md）で管理します。  \n記事ファイルは`public`ディレクトリ内に含める必要があります。\n\n```console\n.\n└─ public\n   ├── newArticle001.md\n   └── newArticle002.md\n```\n\n## Qiita CLI で記事を管理する\n\n### 記事の作成\n\nQiita Preview 上の「新規記事作成」ボタン、または以下のコマンドで新規記事を作成できます。\n\n```console\nnpx qiita new 記事のファイルのベース名\n```\n\n記事のファイルのベース名は自由に変更が可能です。\n\n\u003e 記事のファイル名を`newArticle001.md`にしたい場合は`newArticle001`にします。\n\u003e\n\u003e 例): `$ npx qiita new newArticle001`\n\n作成された記事ファイルの中身は次のようになっています。\n\n```yaml\n---\ntitle: newArticle001 # 記事のタイトル\ntags:\n  - \"\" # タグ（ブロックスタイルで複数タグを追加できます）\nprivate: false # true: 限定共有記事 / false: 公開記事\nupdated_at: \"\" # 記事を投稿した際に自動的に記事の更新日時に変わります\nid: null # 記事を投稿した際に自動的に記事のUUIDに変わります\norganization_url_name: null # 関連付けるOrganizationのURL名\nslide: false # true: スライドモードON / false: スライドモードOFF\nignorePublish: false # true: `publish`コマンドにおいて無視されます（Qiitaに投稿されません） / false: `publish`コマンドで処理されます（Qiitaに投稿されます）\n---\n# new article body\n```\n\nファイルの上部には`---`に挟まれる形で記事の設定（Front Matter）が含まれています。  \nここに記事のタイトル（title）やタグ(tags)などを yaml 形式で指定します。\n\n### 記事の投稿・更新\n\nQiita Preview 上の「記事を投稿する」ボタン、または以下のコマンドで投稿・更新ができます。\n\n```console\nnpx qiita publish 記事のファイルのベース名\n```\n\n以下のコマンドで全ての記事を反映させることができます。\n\n```console\nnpx qiita publish --all\n```\n\n`--force`オプションを用いることで、強制的に記事ファイルの内容を Qiita に反映させます。\n\n```console\nnpx qiita publish 記事ファイルのベース名 --force\n# -f は --force のエイリアスとして使用できます。\nnpx qiita publish 記事ファイルのベース名 -f\n```\n\n### 記事の削除\n\nQiita CLI、Qiita Preview から記事の削除はできません。  \n`public`ディレクトリから markdown ファイルを削除しても Qiita 上では削除はされません。\n\n[Qiita](https://qiita.com)上で記事の削除を行なえます。\n\n## GitHub で記事を管理する\n\n### GitHub の設定について\n\n以下の流れで設定を行うことで、GitHub の特定のブランチにコミットしたタイミングで記事の投稿や更新を行うことが可能になります。\n\n1. GitHub にリポジトリを作成します。\n1. https://github.com/[ユーザー名]/[リポジトリ名]/settings/secrets/actions から、シークレットに`QIITA_TOKEN`という名前で発行した Qiita のトークンを保存します。\n1. qiita init を実行したディレクトリ全体を作成したリポジトリにプッシュします。\n\nデフォルトは`main`または`master`ブランチにコミットがあった場合、自動で Qiita へ記事の投稿・更新がされます。  \n処理の実行の条件は`.github/workflows/publish.yml`から変更することが可能です。\n\n## Qiita CLI のコマンド、オプションについて\n\n### help\n\n簡単なヘルプが見れます。\n\n```console\nnpx qiita help\n```\n\n### pull\n\n記事ファイルを Qiita と同期します。  \nQiita 上で更新を行い、手元で変更を行っていない記事ファイルのみ同期されます。\n\n```console\nnpx qiita pull\n```\n\n`--force`オプションを用いることで、強制的に Qiita 上の内容を記事ファイルに反映させます。\n\n```console\nnpx qiita pull --force\n# -f は --force のエイリアスとして使用できます。\nnpx qiita pull -f\n```\n\n### version\n\nQiita CLI のバージョンを確認できます。\n\n```console\nnpx qiita version\n```\n\n## ユーザー設定ファイルについて\n\n`npx qiita init`コマンドで生成される`qiita.config.json`について説明します。  \nこのファイルを用いて、Qiita CLI の設定を行うことができます。  \n設定できるオプションは以下の通りです。\n\n- includePrivate: qiita.com からダウンロードして保存する記事に限定共有記事を含めるかどうかを選べます。デフォルトは`false`です。\n- host: `qiita preview`コマンドで利用するホストを指定できます。デフォルトは`localhost`です。\n- port: `qiita preview`コマンドで利用するポートを指定できます。デフォルトは`8888`です。\n\n## オプション\n\n### --credential \\\u003ccredential_dir\u003e\n\nQiita CLI の認証情報（`credentials.json`）を配置する・しているディレクトリを指定できます。\nデフォルトでは`$XDG_CONFIG_HOME/qiita-cli`もしくは`$HOME/.config/qiita-cli`になっています。\n\n```console\nnpx qiita login --credential ./my_conf/\nnpx qiita preview --credential ./my_conf/\n```\n\n### --config \\\u003cconfig_dir\u003e\n\nQiita CLI の設定情報（`qiita.config.json`）を配置する・しているディレクトリを指定できます。\n\nデフォルトでは、カレントディレクトリになります。\n\n例）\n\n```console\nnpx qiita login --config ./my_conf/\nnpx qiita preview --config ./my_conf/\n```\n\n### --root \\\u003croot_dir\u003e\n\n記事ファイルがダウンロードされるディレクトリを指定できます。  \nデフォルトでは、カレントディレクトリになります。\n\n例）\n\n```console\nnpx qiita preview --root ./my_articles/\nnpx qiita publish c732657828b83976db47 --root ./my_articles/\n```\n\n### --verbose\n\n詳細なログを出力できます。\n\n```console\nnpx qiita login --verbose\nnpx qiita preview --verbose\n```\n\n## FAQ\n\n### 限定共有投稿をする方法がわからない\n\n[ユーザー設定ファイル](#%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E8%A8%AD%E5%AE%9A%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6)で下記指定をします。  \n`includePrivate: true` (デフォルトは`false`です。)  \nqiita.com からダウンロードして保存する記事に限定共有記事を含めるかどうかを選べます。\n\n[記事ファイル](#%E8%A8%98%E4%BA%8B%E3%81%AE%E4%BD%9C%E6%88%90)で下記指定をします。  \n`private: true`（private: false # true: 限定共有記事 / false: 公開記事）\n\n### エラーが出て解決しない\n\n現在、エラー内容が適切に表示できていない場合がございます。\n\nエラーを解決できない場合は、こちらのDiscussions も参考にしてみてください🙇  \nhttps://github.com/increments/qiita-discussions/discussions/561\n\n## 不具合・ご意見は Discussions へ\n\n不具合・ご意見等ございましたら[Qiita Discussions](https://github.com/increments/qiita-discussions/discussions)へお寄せください。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fincrements%2Fqiita-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fincrements%2Fqiita-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fincrements%2Fqiita-cli/lists"}