ビジュアルモード
公開されたページと同じ見た目で編集できるエディタです。スラッシュコマンド、フローティングツールバー、編集可能なコンポーネントを備えています。
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 と表示され、バナーに理由が説明されます。