Typemark Documentation

ビジュアルモード

公開されたページと同じ見た目で編集できるエディタです。スラッシュコマンド、フローティングツールバー、編集可能なコンポーネントを備えています。

2026年11月19日更新

ビジュアルモードは、エディタを開いたときに最初に表示されるモードです。読者が見るのと同じタイポグラフィと余白でページを編集でき、Typemark は裏側できれいな MDX を書き出します。

上部バー

編集中のページに関する操作は、すべて上部の 1 本のバーにまとまっています。

コントロール機能
ブランチ編集中のブランチを表示し、別のブランチへの切り替えや新規作成を行います。エディタでのブランチを参照してください。
Visual / Sourceビジュアルモードとソースモードを切り替えます
言語複数言語のサイトで、このページを別の言語で開きます。各 AI 翻訳のステータスも表示されます
元に戻す / やり直す編集内容を前後に移動します (ビジュアルモード)
アバターこのページを開いている他のユーザーを表示します
保存状態作業内容が保存済みかどうかを表示します
Preview公開中のサイトでこのページを開きます
Saveすぐに保存します。未保存の変更があるときに表示されます。
Publish保存済みの変更を公開します。プロジェクトが手動デプロイを使用している場合に表示されます。

バーの下にあるバナーには、注意が必要な内容が表示されます。たとえば、サイトがまだオフラインである場合、閲覧専用のプロジェクトである場合、作業中のブランチなどです。

保存

入力を止めてから 3 秒後に Typemark が自動保存します。Cmd+S を押すと、すぐに保存されます。保存状態は次のいずれかで表示されます。

  • Saved: すべての変更がリポジトリにコミットされています
  • Saving…: 保存中です
  • Unsaved changes: まだ保存されていない変更があります
  • Couldn't save: 保存に失敗しました。変更はエディタに残っています。もう一度お試しください。

保存後、ページはバックグラウンドでビルドされます。ビルド中は Building、問題が発生すると Build failed が表示されます。未保存の変更がある状態でページを離れようとすると、Typemark が確認を求めます。

タイトルと説明

ページのタイトルと説明は、読者に表示される位置にあります。どちらかをクリックすると編集できます。Typemark は両方の値をページのフロントマターに保存し、その他のフロントマターのフィールドは書かれたとおりに残します。icon などのフィールドを編集するには、ソースモードを使用してください。

スラッシュコマンド

/ を入力するとコマンドメニューが開きます。名前を入力して絞り込めます。たとえば /call で Callout、/code で Code block と Code group が見つかります。

コマンド挿入されるもの
Heading 1, 2, 3セクション見出し
Bullet list箇条書きリスト
Numbered list番号付きリスト
Task listチェックリスト
Code blockシンタックスハイライトと言語選択機能付きのコード
Blockquote引用ブロック
Callout情報、警告、危険、またはヒントのボックス
Accordion折りたたみ可能なセクション
Steps番号付きのステップ形式ガイド
Tabsタブ付きのコンテンツ
Code groupタブ付きのコードブロック
Cardタイトル、アイコン、リンク付きのカード
Card groupカードのグリッド
Imageパソコンから画像をアップロード
Videoリンクから YouTube、Vimeo、Loom、Wistia の動画、または動画ファイルを埋め込み
Tableヘッダー行付きの 3 行 3 列の表
Divider水平線

AI のコマンドはメニューの下部にあります。Ask AI、Continue writing、Draft with AI、Improve writing、Auto-structure です。空の行で Space を押すか、どこでも Cmd+J を押すと、AI に質問できます。AI によるライティングを参照してください。

ブロックハンドル

任意のブロックにカーソルを合わせると、左余白にハンドルが表示されます。

  • + は下にブロックを追加し、スラッシュメニューを開きます
  • グリップをドラッグするとブロックを移動できます。コンポーネントの内外への移動も可能です
  • グリップをクリックするとブロックメニューが開きます。Turn into、Insert block above、Insert block below、Move up、Move down、Duplicate、Delete があります

Cmd+. を押すと、カーソルがあるブロックのブロックメニューが開きます。ブロックの削除時に確認は求められません。Cmd+Z で元に戻せます。

フローティングツールバー

テキストを選択すると、フローティングツールバーが表示されます。

  • Bold、italic、strikethrough
  • Inline code
  • Link (URL を入力する欄があります)
  • プロジェクトのプランに AI によるライティングが含まれている場合、Ask AI が先頭に表示されます

コンポーネントの編集

コンポーネントは生のコードではなく、その場で編集できるブロックとして表示されます。

  • Callout: ドロップダウンからタイプを選び、必要に応じてタイトルを追加します。
  • Tabs と Code group: タブバーから、タブの追加、名前変更、並べ替え、削除ができます。
  • Steps と Accordion: 各ブロック上部のタイトルを編集します。
  • Card: アイコンを選び、タイトルと任意のリンクを設定します。
  • Card group: 列数を選び、Add card をクリックします。
  • Code block: 選択画面から言語を選びます。Mermaid ブロックでは、コードの下にダイアグラムが表示されます。
  • Video: リンクを貼り付けるか、Change link をクリックして差し替えます。動画を参照してください。
  • Table: セルを選択して行や列を追加・削除できます。表そのものを削除することもできます。

画像には、サイズと代替テキストを設定するための専用ツールバーがあります。画像を参照してください。

ビジュアルモードで開けないページ

ビジュアルエディタでページを安全に開けない場合、代わりにソースモードで開き、理由を示すバナーを表示します。そこで MDX を修正してから Visual に戻してください。ビジュアルエディタは、読み込めなかったページを上書き保存することはありません。

サイドバー

サイドバーには 2 つの表示があります。

  • Navigation は、読者が見るのと同じ形で、サイトのタブ、グループ、ページを表示します。ページをドラッグして並べ替えたり、グループ間で移動したりできます。グループにカーソルを合わせて + をクリックするとページを追加できます。Add group と Add tab で構造を広げられ、… メニューからグループやタブの名前変更・削除ができます。
  • Files はリポジトリ内のすべてのファイルを表示します。.mdx または .md ファイルをクリックすると開きます。

Navigation 表示での変更は typemark.json に保存されます。ナビゲーションを参照してください。

共同作業

同じページを開いているチームメンバーがいると、上部バーにそのアバターが表示されます。あなたがページを開いている間に別のユーザーが保存した場合は、その旨の通知が表示されます。

Typemark は同時編集を自動でマージしません。他のユーザーの後に保存しようとすると、上書きせず処理を停止し、ページの再読み込みを求めます。再読み込みすると相手の版が表示され、未保存の変更は失われるため、残したい内容は事前にコピーしてください。

読み取り専用

閲覧者や、Free プランでロックされたプロジェクトは読み取り専用モードで開きます。保存状態には Read-only と表示され、バナーに理由が説明されます。