SpecDown

共有・表示モード

リンクでドキュメントを共有 — 閲覧者はアカウント不要。表示モードはMarkdownを美しくレンダリングし、 Mermaidダイアグラムを完全サポートします。

ドキュメントを共有するには:

  1. エディターでドキュメントを開く。
  2. 上部ツールバーの Share ボタンをクリック。
  3. 共有タイプを選択(下記参照)し、Create link をクリック。
  4. 生成されたリンクをコピーして共有。

共有リンクの形式: https://specdown.app/share/abc123xyz

共有タイプ

公開

リンクを持つ誰でもドキュメントを閲覧可能。認証不要。全プランでデフォルト。

パスワード保護

Pro

閲覧する前にパスワード入力が必要。外部関係者やドラフトに最適。

期限付きリンク

Pro

指定日後に自動で無効化。期間限定レビューに最適。

表示モードUI

共有ビューでは次のように表示されます:

  • シンタックスハイライト付きのレンダリング済みMarkdown
  • インタラクティブなMermaidダイアグラム
  • プロジェクト構成を示す折りたたみ式ファイルツリー
  • ドキュメント間のパンくずナビゲーション
  • 長文書の目次
  • ダーク/ライトモード切り替え
  • 動作するインラインリンク: Markdown 内で同じプロジェクトの別ドキュメントを指すリンクは 共有セッション内で遷移します — [Spec 001](/srs/SPEC-001) や Wiki リンク [[/srs/SPEC-001]] をクリックすると、共有を再読み込みせずにアクティブドキュメントが切り替わります。

HTML ドキュメントの共有

単一の .html ドキュメント(または既存の .html 添付ファイル)を共有すると、 生 HTML がページ全体として配信されます — SpecDown ヘッダーなし、周囲のクロームなし、iframe ラッパーなし。 共有 URL は HTML を直接ホスティングしているかのように動作します。

  • パスワード保護された HTML 共有では先にパスワードゲートが表示され、認証後に同じ方法で生 HTML が配信されます。
  • HTML 内のスクリプトはサンドボックス origin(CSP ヘッダー経由)で実行されるため、SpecDown の Cookie を読んだり閲覧者のセッションで API を呼んだりはできません。
  • プロジェクト/フォルダ共有内の HTML ファイルはファイルツリーを使えるように通常の SpecDown クロームを維持します。生 HTML を配信するのは単一ターゲットの HTML 共有のみです。
  • プロジェクト/フォルダ共有で HTML ドキュメントや既存の HTML 添付を表示すると、プレビュー領域は最初の描画時から残りの表示領域いっぱいに広がります。以前のような固定の低い高さで開くことはなくなりました。

表示モードでのコメント

共有ビューではコメント機能が常に有効です — 先に何かのモードを ON にする必要はありません。 ドキュメント内のテキストを選択するだけで、選択範囲の隣に浮遊する Comment バッジが表示され、 クリックするとその箇所に紐付いた新しいスレッドが開始されます。

  • 共有ヘッダーの チャットアイコンはコメントサイドバーの表示/非表示だけを切り替えます。コメント機能自体を ON/OFF するものではなくなりました。
  • サイドバーは記事を最大幅で読めるように初期状態は閉じです。閲覧者が選んだ最後の状態(開く / 閉じる)はブラウザに記憶されます。
  • サイドバーが閉じているときに浮遊する Comment バッジをクリックすると、自動でサイドバーが開きコンポーザにフォーカスが当たります。
  • 公開・解除済みの共有は匿名閲覧者からのコメントを受け付けます。プライベート共有ではサインインが必要です。

編集ボタン

共有ビューの右上に Edit ボタンが表示されます。 動作は閲覧者とプロジェクトの関係により異なります:

閲覧者Editボタンの動作
未ログイン/login にリダイレクト
ログイン済み、Editor/Admin/Owner権限エディターでドキュメントを開く
ログイン済み、プロジェクトアクセスなしフォーク/アクセス申請モーダルを表示

ドキュメントのフォーク

共有ドキュメントの編集権限がない場合、Fork できます。 フォークするとドキュメントが自分のプロジェクトにコピーされ、自由に編集できます。

ユースケース: ベンダーが仕様テンプレートを共有。チームは自分のプロジェクトにフォークしてカスタマイズ。元のドキュメントには影響しません。

Shareダイアログでいつでも次の操作ができます:

  • ドキュメントの全アクティブ共有リンクを表示
  • 個別リンクのコピーまたは無効化
  • 既存リンクのパスワードや有効期限の更新
リンクを無効化すると即座に使えなくなります。古いURLを持つ閲覧者は「ページが見つかりません」と表示されます。

検索エンジンとインデックス

共有ページは Google などの検索エンジンにインデックスされません。 公開・パスワード保護・プライベートの種類を問わず、すべての共有リンクにnoindex タグが付与されています。リンクを送った相手だけに届く設計です。 ドキュメントを検索に出したい場合は、ご自身のサイトや公開ブログから発信してください。

始める準備はできていますか?

コードのようにSpecを書く。Gitと同期する。チームと共有する。