概要

Prosefly には2つのエディターがあります。ビジュアルエディターは Markdown・MDX 文書を、リソースエディターは JSON・YAML のデータファイルを扱います。どちらも下書きをコンテンツスペースに保存し、公開は別の操作で行います。

登録せずにエディターを試す

リポジトリを接続する前に、Markdown のサンプル でサンプル文書を編集できます。Starlight、Fumadocs、Prosefly のサンプルで、対応する MDX コンポーネント、ページ属性、ナビゲーション、差分の比較を試せます。

変更は現在のタブだけに保存され、再読み込みでリセットされます。サンプルは GitHub に接続せず、共有の下書きの保存や公開も行いません。

エディターを選ぶ

コンテンツ	エディター	ガイド
Markdown・MDX 文書	ソースモードを備えたビジュアルエディター	ビジュアルエディター
JSON・YAML リソース	ビジュアル・コードモードを備えたリソースエディター	リソースエディター

開くエディターは、コレクションのファイル形式と設定で決まります。リソースファイルは文書の本文ではなく、項目や一覧として編集します。

Markdown とコンポーネントの対応

どのエディタープロファイルも、対応する Markdown の基本機能を含みます。基本から始め、表、タスクリスト、コード、図、数式、画像、メディア、脚注の個別ガイドをご覧ください。Mermaidと数式ではプロファイルごとの表示を、脚注では文書内の参照を確認できます。

MDX では、文書に使うコンポーネントに合うプロファイルを選びます。Starlight、Fumadocs、Prosefly に対応しています。MDX コンポーネントの各ガイドでは、画面の操作、ソース構文、プロファイルによる違いを説明します。例えばコールアウトは3つすべてに対応し、アコーディオンでは Fumadocs・Prosefly のグループと Starlight Details を扱い、リンクボタンは Starlight 専用です。

エディターはリポジトリのコードを実行せず、サイト全体を再現するものでもありません。独自のコンポーネントや未対応の式はソースで編集できます。最終的な表示は、サイト自身のビルドで確認してください。

下書きと公開

文書のビジュアル編集は自動保存されます。移動する前に保存状態を確認してください。リソースは Save draft が必要です。下書きの保存では、Git リポジトリは変わりません。

公開前に公開前レビューで実際のファイルの差分を確認します。コミットかプルリクエストかは、コンテンツスペースの公開設定で決まります。

執筆を支援する機能

AI ライティングで選択した文章を整えたり、言語と翻訳で設定済みの別の言語の記事を作成したりできます。生成された下書きは公開前に確認してください。