Typemark Documentation

AI によるライティング

AI に、ページの執筆・書き直し・レビュー・リンク追加を依頼したり、すべてのページを一度に変更させたりできます。変更内容は、自分のものになる前に一つずつ確認できます。

2026年11月19日更新

AI はビジュアルエディタの一部です。文章の書き直し、段落の続き作成、ページのレビュー、他のページへのリンク追加、サイト全体での名称変更などを AI に依頼できます。AI の提案はすべてページ内に表示され、承認するか却下するかを選べます。承認するまで何も変更されません。AI は Pro と Enterprise で利用でき、クレジットの購入は不要です。

Ask AI

Ask AI は、カーソルがある文章を対象に動作します。次のいずれかの方法で開けます。

  • 段落内、またはテキストを選択した状態で Cmd+J を押します。
  • テキストを選択し、フローティングツールバーの Ask AI をクリックします。
  • 空の行で Space を押します。
  • / と入力し、Ask AI を選びます。

やりたいことを入力し(「もっと親しみやすくして」「表に変換して」「Python の例を追加して」など)、Enter を押すか、候補から選びます。

テキストがある場合空の行の場合
文章を改善、スペルと文法を修正続きを書く
短くする、長くする、言葉を平易にする導入文を書く
トーンを変更:親しみやすく、よりプロフェッショナルに、より直接的に、より自信のある表現にコード例、トラブルシューティングの節、FAQ、または次のステップを追加
変換:手順、箇条書き、表、コールアウト、またはコンポーネントに要約を作成
別の言語に翻訳、例を追加入力した任意の内容

↑ と ↓ で候補を移動し、→ で選択肢の多い候補を開けます。

提案をレビューする

AI は、カーソルの後ろのページ内に淡いハイライト付きで書き込むため、完成時の見た目をそのまま確認できます。見出し、リスト、コールアウトは実際のブロックとして表示されます。完了すると次のようになります。

  • 小さな書き換えは一つの文章としてまとめられ、削除された語は取り消し線、新しい語はハイライトで示されます。
  • 大きな変更では、元のテキストに取り消し線が付いた状態で、その上に新しい版が表示されます。
  • Accept(Cmd+Enter)で採用します。Cmd+Z で元のテキストに戻せます。
  • Discard(Esc)で破棄し、ページは元の状態のままになります。
  • Try again で別の版を依頼できます。
  • Tell AI what to change で提案を調整できます(「もっと短く」「二文目は残して」「よりフォーマルに」など)。

採用するまでページは元の状態で保存されているため、採用しなかった提案が公開されることはありません。

新しいテキストはカーソルがある段落の後ろに入り、単語の途中に挿入されることはありません。空の行では、その行に置き換わります。

アシスタント

上部バーの Assistant をクリックするか、ページに文字を入力していないときに Cmd+J を押します。画面が広い場合は閉じるまで自動的に開いたままになり、スマートフォンでは全画面で開きます。アシスタントは、開いているページとドキュメント全体を把握しています。質問したり、変更内容を指示したりできます。

  • Review this page:わかりにくい点、誤り、不足、順序の問題を、修正案とともに指摘します
  • Suggest links to other pages:自分のページへのリンクを、実際のパスを使って追加します
  • Make it easier to scan、Add a troubleshooting section、Check it against the other pages
  • その他の依頼:「これは Windows でも正しいですか?」「サンドボックスキーも使えることを注記して」など

変更は理由付きの提案としてページに表示されます。ページ下部のバーで一つずつ確認でき、Accept または Reject を選ぶか、Accept all でまとめて採用できます(Cmd+Z 一回で全てを取り消せます)。アシスタントが自力で解決できない事項(確認できない事実など)は、該当ブロックの横に点線で示されます。

質問する前にテキストを選択しておくと、アシスタントはその部分に集中します。

すべてのページを変更する

アシスタントを All pages に切り替え、変更内容を記述します(「Acme Platform を Acme Cloud に変更」「log in ではなく sign in と書く」など)。アシスタントは影響を受けるページを見つけ、ページごとに変更案を提示します。その後、提案した変更の数と対象ページを報告します。変更が不要だったページは一行にまとめられます。

Review changes またはリストのページをクリックすると、各変更を前後の文章とともに確認できます。変更は、ページ内で対象テキストが出現するすべての箇所に適用され、複数箇所に及ぶ場合はレビューに表示されます。不要な変更は Reject し、除外したいページのチェックを外してから Apply をクリックします。残した変更は一つのコミットとしてまとめて反映され、それまではどのページも変更されません。レビューを閉じても選択内容は保持され、別のページを開いても提案はアシスタントに残ります。Open page をクリックするとページが新しいタブで開くため、レビューを離れずに確認できます。不要になった場合は Discard をクリックします。

開いているページに未保存の編集がある場合は、先に保存されます。変更は適用時点のページ内容に対して行われるため、アシスタントがページを読み込んだ後の編集も保持されます。対象テキストが既に存在しない変更は除外され、アシスタントがその旨を通知します。

考えが変わった場合は、Undo で適用前の状態に戻せます。これは新しいコミットとして記録されます。その後に別の人が編集したページは、そのままになります。

アシスタントは一度に最大 12 ページを処理します。該当ページがさらにある場合は、Continue をクリックすると次のページ群を処理します。

読者が見つけられなかった内容

アシスタントは、過去 30 日間に読者がサイト上で検索した、またはこの Ask AI で質問した内容のうち、ドキュメントで答えられなかったものを一覧表示します。項目をクリックすると、アシスタントがその答えをページに追加するか、どのページに入れるべきかを教えてくれます。

概要ページから

プロジェクトの概要には、ドキュメント全体に対する変更を AI に依頼するボックスがあります。読者が見つけられなかった質問への回答、互いに矛盾するページの検出、ページ間のリンク提案などの候補が用意されています。クリックするとエディタが開き、アシスタントは All pages に設定され、依頼内容が入力された状態になります。送信するまで何も実行されません。

説明文を書く

タイトルの下の説明文の横にある Write with AI をクリックします。説明文が既にある場合は Rewrite with AI と表示されます。AI がページを読み、検索エンジンや AI アシスタントがタイトルの下に表示する一文を作成します。

Cmd+K で検索・実行する

エディタで Cmd+K を押すと、ページを開いたり、コマンド(アシスタントを開く、このページをレビュー、説明文を書く、Source に切り替える、プレビュー、公開)を実行したり、AI に質問したりできます。ページ名を入力するとそのページが開きます。質問を入力して Enter を押すか、いつでも Cmd+Enter を押すと、アシスタントに質問できます。

AI に書き方を伝える

Settings > AI writing で、エディタのすべての AI リクエストに従う指示を記述します。文体、製品の正式名称、使う言葉と避ける言葉、英式か米式かの綴りなどを指定できます。指示は typemark.json に ai.instructions として保存され、最大 2,000 文字です。

{
  "ai": {
    "instructions": "Write in British English, in the second person. The product is \"Acme Pay\", never \"AcmePay\"."
  }
}

AI は、依頼内容に最も関連するページも読み込むため、文体を合わせ、用語を統一して使います。AI 翻訳も、トーンについては同じ指示に従います。

利用できるユーザー

AI によるライティングは、プロジェクトオーナーのプランに従います。

  • オーナーが Pro または Enterprise の場合、そのプロジェクトのエディタまたはオーナーのロールを持つ全員が、自分のアカウントが Free であっても利用できます。
  • オーナーが Free の場合、AI コマンドは Pro バッジ付きで表示されます。クリックすると Billing ページが開きます。
  • 閲覧者はページを変更できないため、AI によるライティングは利用できません。

プランについては Billing、ロールについては Team members を参照してください。

公正な利用について

クレジットの追跡はありません。全員にとってサービスを快適に保つため、一人あたりに、1 分あたりと 1 日あたりのリクエスト上限、および月間の利用枠が設けられています。全ページにわたる変更は、複数のリクエストとして数えられます。上限に達した場合、エディタにリセットされるタイミングが表示されます。1 日の上限は UTC の午前 0 時にリセットされ、月間の利用枠は毎月 1 日にリセットされます。

コンテンツについて

Typemark は、作業中のテキスト、ページ、およびプロジェクト内の関連ページの抜粋を、AI プロバイダーに送信します。リクエストは、お客様のデータを保存せず、学習にも使用しないモデルプロバイダーにのみ転送されるよう要求しています。

読者がサイト上で検索した内容は、90 日間保存され、見つけられなかった内容を確認するために使われます。IP アドレスや、読者を特定できるその他の情報は保存されません。