---
title: "Documents | ワークスペースでMarkdownを活用 | Postman"
description: "Postman Documentsなら、Markdownをワークスペースのリソースとして活用できます。README、計画、手順書をAPIやコードと同じ場所に置き、Gitで管理できます。"
url: https://www.postman.com/jp/product/documents/
---

# Documents | ワークスペースでMarkdownを活用 | Postman

> Postman Documentsなら、Markdownをワークスペースのリソースとして活用できます。README、計画、手順書をAPIやコードと同じ場所に置き、Gitで管理できます。

## Documents

APIに関する情報をMarkdownファイルにまとめ、関連する作業と同じ場所で管理できます。チームやAIが参照でき、Gitで管理できます。

[無料で始める](https://identity.getpostman.com/signup?continue=https%3A%2F%2Fgo.postman.co%2Fhome)
[ドキュメントを見る](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/overview/)

---

## チームとAIで共有できるコンテキスト

### 人にもAIにも扱いやすい

Postmanエディターでは、見やすく整形された表示でもMarkdownのRaw表示でも編集できます。人には読みやすく表示しながら、AIもMarkdownを効率よく読み書きできます。

### Gitでバージョン管理

Native Gitを使えば、Documentsをコードと同じ場所で、使い慣れたGitワークフローを使って管理できます。

### ワークスペースの権限でアクセスを管理

Documentsにはワークスペースのロールと権限が適用されるため、適切なユーザーだけが閲覧・編集できます。

---

## チームのコンテキストを理解するAIで、API開発を加速

DocumentsにAPIチームの進め方を記録しておくことで、Postman AIがそのコンテキストを継続的に参照できます。APIの設計から公開・提供まで幅広い作業に活用でき、計画や結果も記録してチームで確認できます。

---

*機能*

### APIチームの作業の進め方に合わせて設計

README、計画、ランブック、標準を、仕様やコレクションと同じワークスペースにまとめ、Native Gitで管理できます。

### APIの入り口を分かりやすく

はじめに読むDocumentをワークスペースに固定表示しておけば、APIで何ができるのか、誰が管理しているのか、どこから始めればよいのかを、誰でもすぐに確認できます。

### 破壊的変更とあわせて移行ガイドを提供

アップグレードの手順と廃止までのスケジュールをDocumentにまとめ、破壊的変更と同じプルリクエストでコミットできます。

### パートナーのオンボーディングを迅速に

Partner APIのセットアップ手順、サンドボックスの詳細、初回APIコールまでの手順をDocumentにまとめ、コレクションと同じ場所で管理できます。

### 仕様のそばに設計判断を記録

エンドポイントを設計した際の判断やトレードオフをDocumentに記録し、仕様と同じ場所で管理できます。

### テストの意図をテストと一緒に記録

テストの目的や判断の背景を記録しておくことで、テストを実行・保守する誰もが確認できます。

### Monitorのそばにランブックを配置

Monitorが実行するコレクションと同じ場所にランブックをDocumentとして置くことで、障害発生時にオンコール担当者がすばやく対応できます。

---

*リソース*

## ワークスペースの活用方法をさらに詳しく

### ワークスペースで作業を整理

ワークスペースでは、コレクション、仕様、環境、Documentsをひとつの場所にまとめ、チームで必要なものを見つけて利用できます。詳しい活用方法をご覧ください。

[ドキュメントを読む](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/overview/)

### ワークスペースをNative Gitと連携

Native Gitを使って、Documents、コレクション、仕様をコードと同じリポジトリで管理できます。

[ドキュメントを読む](https://learning.postman.com/docs/use/native-git/overview/)

### ロールと権限を管理

Documentsを含むワークスペース内のリソースについて、誰が閲覧・編集できるかを管理できます。

[ドキュメントを読む](https://learning.postman.com/docs/collaborating-in-postman/roles-and-permissions/)

---

## Documentsについて詳しく見る

Documentsを活用して、APIに関する情報を常に最新の状態に保ち、必要なときにすぐ見つけられるようにする方法をご紹介します。関連する作業と同じ場所で情報を管理する方法もご紹介します。お気軽にご相談ください。