---
title: Contentful
description: >-
  contentful() ソースを使用して Delivery API 経由で Contentful のコンテンツタイプを読み込み、リッチテキスト本文を Markdown に変換します。追加のインストールは不要です。
---

組み込みの `contentful()` アダプターは、Content Delivery API を通じて 1 つのコンテンツタイプのエントリーを読み込み、各エントリーのリッチテキスト本文を Markdown に変換します。見出し、マーク、リンク、リスト、引用、テーブル、埋め込みアセットは、それぞれ対応する Markdown の要素に変換されます。Markdown の長文テキストフィールドに保持された本文は、記述されたとおりにそのまま渡されます。ただし、Web、メール、電話、相対アドレスのいずれでもないリンク（たとえば `javascript:` URL）は、リッチテキストの場合と同様にラベルのみが残ります。アダプターは REST API と直接通信するため、何もインストールする必要はありません。

```ts blume.config.ts
import { defineConfig } from "blume";
import { contentful, filesystem } from "blume/sources";

export default defineConfig({
  content: {
    sources: [
      filesystem({ root: "docs" }),
      contentful({
        prefix: "guides",
        space: "abc123",
        contentType: "guide",
        // environment: "master", locale: "en-US"
        // Field ids default to title / description / slug / body, and the
        // date to sys.updatedAt
        fields: { body: "content" },
        // Extra Delivery API query parameters
        params: { "fields.section": "sdk" },
      }),
    ],
  },
});
```

Delivery API のトークンは、アダプターが宣言する `CONTENTFUL_ACCESS_TOKEN` 環境変数から取得されます。`--preview` を指定すると、アダプターは `CONTENTFUL_PREVIEW_TOKEN` を使用して Preview API から下書きを読み込みます。Preview API は配信用トークンを受け付けません。そのため、プレビュー用トークンなしで `--preview` を指定した場合は、`CONTENTFUL_ACCESS_TOKEN` にフォールバックせず、明確なエラーで失敗します。アセットはダウンロードされず、Contentful の CDN から参照されます。これらの URL は変わらないためです。`contentfulSource` を直接構築して [`custom()`](/ja/docs/content/sources/custom) に渡す場合は、エンジンの `serializers` オプションを使用して、埋め込みエントリーを Blume コンポーネントにマッピングできます。このオプションのキーにはコンテンツタイプ ID を指定します。`serializers` を設定すると、返されたコンポーネントがレンダリングされるように、そのソースのページは MDX として書き出されます。シリアライザーが設定されていない埋め込みエントリーは、その旨がコメントとして出力されます。別のエントリーへのリンクには参照先のルートがないため、プレーンテキストとしてレンダリングされます。