記事一覧

EmDashのCLIで記事を作る・直す・公開する|contentコマンドの使い方

EmDashにはコマンドで記事を扱うCLIが付いています。npx emdash --help で確かめたコマンドの一覧と、記事の作成・更新・予約のしかたをまとめます。

EmDashのCLIで記事を作る・直す・公開する|contentコマンドの使い方

EmDash には、コマンドで記事を扱う道具(CLI)が付いています。雛形のフォルダで npx emdash --help を打つと、使えるコマンドの一覧が出ます。

コマンドの一覧

編集部の環境(EmDash 1.3 系の雛形)で出た一覧です。

  • init … 雛形の設定からデータベースを作る
  • types … 記事の型から TypeScript の型を作る
  • doctor … データベースや予約処理の状態を点検する
  • seed … seed ファイルをデータベースへ入れる
  • migrate … データベースの更新を確かめる・当てる
  • export-seed … 今の中身を seed ファイルとして書き出す
  • secrets … 暗号化の鍵などを作る・確かめる
  • login / logout / whoami … 公開中のサイトへのログイン
  • content … 記事の一覧・作成・更新・削除・公開
  • schema … 記事の型(項目)の管理
  • media … 画像などの管理
  • search … 全文検索
  • taxonomy … カテゴリー・タグ
  • menu … メニュー
  • site … サイト全体を .emdash ファイルとして書き出す・読み込む

前半(init〜secrets)は手元のファイルやデータベースに対して動き、後半(login 以降)は動いているサイトに対して動きます。

記事を作る

npx emdash content create posts --data '{"title": "はじめての記事", "body": "# こんにちは"}'
npx emdash content create posts --file post.json --slug hello-world

作るとそのまま公開されるのが既定です。下書きにしておきたいときは --draft を付けます。

一覧と中身を見る

npx emdash content list posts --status published --limit 10
npx emdash content get posts <記事のID>

get は本文(Portable Text)を Markdown に直して表示します。そのままのデータを見たいときは --raw を付けます。

直す

npx emdash content update posts <記事のID> --rev <版の印> --data '{"title": "新しいタイトル"}'

--rev には、直前に get したときの版の印を入れます。ほかの人が先に直していたら、上書きせずに止まる仕組みです。

予約公開

npx emdash content schedule posts <記事のID> --at 2026-11-01T09:00:00Z

時刻は世界標準時(末尾の Z)で書きます。日本時間の朝9時なら、前日の 00:00:00Z です。

公開中のサイトに使うとき

公開中のサイトに対して使うときは、先にログインします。

npx emdash login --url https://<サイトのURL>

関連記事