Markdown にも
電子署名を

本文の最終行に署名を追加し検証する、Markdown のためのオープンフォーマットです。署名は HTML コメントとして記述するため、表示には影響せず、ファイルも1つのまま。あとから何人でも連署できます。

contract.mdソース
  1. # 業務委託契約書
  2. 甲と乙は、以下の条件で合意する。
  3. 1. 乙は、別紙の業務を 2026年12月末までに納品する。
  4. 2. 甲は、納品後30日以内に代金を支払う。
  5. <!-- md-signature
  6. signer: github.com/alice
  7. role: author
  8. hash: sha256:3a0d…
  9. -->
  10. <!-- md-signature
  11. signer: example.com
  12. role: approver
  13. hash: sha256:8f43…
  14. -->

検証済み

署名ブロックは、それより前のすべて(本文と先行する署名)のハッシュに署名します。どのブロックも HTML コメントのため、表示には現れません。
単一ファイル
.sig などの別ファイルは不要です。メール添付でも Git 管理でも、そのまま受け渡せます。
既存の鍵で署名
GitHub 登録済みの SSH 鍵、自社ドメインの DNS、パスキーを署名と検証に使用します。
事業者に非依存
仕様は CC0、実装は MIT。特定のサービスが終了しても、文書の検証は継続できます。
ブラウザ内で完結
検証も署名も Web 標準の暗号 API で処理します。文書をサーバへ送信しません。外部への接続は、公開鍵と撤回リストの取得のほか、利用者が有効化・許可・指定した接続(リモートのリソース、文書が指定するホスト、検証サーバ)に限ります。

md-signature の意義

文書と署名を1つのファイルにまとめると、AI を含む自動化の安全性、記録の持ち運び、長期の検証が同時に成り立ちます。

  1. 契約業務に非プロプライエタリ

    Markdown は、PDF のような独自形式と違い、誰でも読めるテキストです。署名に使用する鍵は手持ちの SSH 鍵や自分で生成した鍵で足り、有料の証明書や電子契約サービスの契約は不要です。

  2. 脱プラットフォーム・データの自己完結

    署名は文書の中にあります。サービスの解約や事業終了、アカウントの削除があっても、ファイルさえあれば検証を継続できます。仕様は CC0、実装はオープンソースです。

  3. 時刻の証明と長期の証拠性

    RFC 3161 のタイムスタンプで、その時点に署名が存在したことを第三者の時刻認証局(TSA)が証明します。署名者が申告する時刻と違い、あとから改変できません。将来 Ed25519 が危殆化した場合も、耐量子署名のアルゴリズムが規定されれば、その署名を追記してチェーン全体を保護できます。

  4. 発行元が署名した証明書

    大学や企業が、自組織のドメインの DNS に公開した鍵で修了証や在籍証明に署名できます。受け取った側は、その組織が発行したものかを自分で確認できます。Verifiable Credentials を簡素にした使い方です。

  5. 承認ワークフロー

    稟議、契約、仕様変更、リリース判定など、承認が必要な手順を文書だけで進められます。require に必要な承認者を宣言し、各担当者が順に連署します。CI やブランチ保護で mdsig verify を実行すれば、全員の署名がそろうまで次の工程に進みません。

  6. Git で扱える合意記録

    署名の追加はファイル末尾への追記なので、差分が読みやすく、誰がいつ何に署名したかを PR でレビューできます。履歴の書き換えも署名の検証で検出されます。

  7. AI エージェント指示書の改ざん防止

    CLAUDE.md や AGENTS.md に署名し、実行環境(フックや CI)が読み込み前に mdsig verify で照合します。PR や再配布の過程で書き換えられた指示書は、エージェントが読む前に拒否されます。ツールの出力や Web ページ経由の注入は対象外です。

  8. AI と人間の協調(Human-in-the-loop)

    AI が生成・修正した文書や設定に、責任者がパスキーや SSH 鍵で連署するまで、CI は適用を保留します。require に指定した連署がそろわない間、mdsig verify は終了コード 5 を返します。

  9. RAG・ナレッジベースの汚染対策

    取り込み処理で、承認者(role: approver)の有効な署名がある文書だけを索引に登録します。偽の文書や途中での改変は検知できます。承認者自身の判断の誤りまでは防げません。

  10. 添付ファイルまで含めた証跡

    スクリーンショットやデータファイル、リモートの画像をハッシュで固定します。本文だけでなく、参照先の差し替えも検知できます。

  11. 機密文書を外部に出さない

    検証も署名もブラウザ内またはローカルの CLI で完結し、文書をサーバへ送信しません。tofu 方式ならネットワーク接続なしでも検証できます。

電子署名としての法的な扱いは、使用する鍵、運用、適用される法令によって異なります。

仕組み

  1. 末尾に署名ブロックを追記

    署名は HTML コメントのため、GitHub や VS Code の表示には出ません。本文は一切変更しません。

  2. 連署は先行する署名ごと保護

    2人目の署名は、本文と1人目の署名をまとめて対象とします。途中を改変すると、それ以降の署名はすべて無効になります。

  3. 公開鍵は既存の公開先から取得

    GitHub に登録済みの SSH 鍵、自社ドメインの DNS TXT レコード、パスキーなど。検証のための新規アカウントは不要です。

<!-- md-signature
v: 0.0.2
method: git-hosting
signer: github.com/alice
key_fp: SHA256:Rx9i…
role: author
ts: 2026-11-16T09:00:00Z
require: |
  dns:example.com approver
alg: ed25519
hash: sha256:3a0d…
sig: base64:q1Xv…
-->

他方式との比較

項目 md-signature 電子契約サービス 別ファイル署名(.sig / .asc) PGP クリア署名
単一ファイルで完結 対応 PDF と事業者側の記録 2ファイル 対応
表示への影響なし 対応HTML コメント PDF のみ 対応 署名文字列が表示される
複数人の署名 対応追記型ハッシュチェーン 対応 署名者ごとに別ファイル 入れ子構造で扱いにくい
事業者なしで検証可能 対応公開仕様 事業者に依存 対応 対応
既存の鍵を使用可能 対応SSH 鍵・DNS・パスキー・OpenPGP 鍵(gpg やスマートカードで署名、WKD・keys.openpgp.org で公開) サービスのアカウント PGP / SSH PGP のみ
ブラウザのみで動作 対応Web Crypto のみで実装 サービスの Web アプリ 限定的 限定的

対応限定的

次の一歩

ブラウザで動作を確認し、仕様を読み、手元の環境に導入できます。