はじめに

翻訳した README.md: next-mdx-remote

今回、next-mdx-remote の公式 README.md を翻訳しました。この前、私のブログをリファクタリングしながら、このライブラリを使いました。

当初、私は自分用に直接 CMS（コンテンツ管理システム）を作成しました。しかし、最近様々な公式ドキュメントを翻訳し、私のサブドメインで公開する中で、ある気づきがありました。それは、私のブログも公式ドキュメントのように静的サイトで作るといいかもしれないと思いました。静的サイトはサーバーサイドレンダリング（SSR）で作成するのが一般的です。そのため、Markdown をクライアントサイドでレンダリングしていた従来の方法をやめて、サーバーサイドでレンダリングすることに決めました。

そして、Docusaurus や Nextra などの文書化ツールでは MDX を支援しています。私も私のブログで MDX を使いたかったです。

これらの条件を満たすために、next-mdx-remote が最適だと思いました。

まず、MDX が見慣れない人がいるかもしれないので、MDX とは何かを説明します。

MDX とは？

MDX の公式ドキュメントには以下のように書かれています。

MDX では、マークダウンコンテンツ内で JSX を使用することができます。インタラクティブなチャートやアラートなどのコンポーネントをインポートして、コンテンツ内に埋め込むことができます。これにより、コンポーネントを使って長文のコンテンツを書くのがとても楽しくなります。🚀

― MDX

簡単に言うと、MDX はマークダウンに JSX を使えるようにしたものです。これにより、マークダウンの中に React コンポーネントを埋め込むことができます。

example.md

# Title

This is a content block.

- Item 1
- Item 2
- Item 3

既存のマークダウンでは上のように書くことができますが、MDX では以下のように書くことができます。

example.mdx

# Title

This is a content block.

- Item 1
- Item 2
- Item 3

<Counter />

<MyCustomComponent message="Hello from MDX!" />

自分が定義した React コンポーネントを使うことができるので、より柔軟なコンテンツを作ることができます。プログラミングが上手い人には、自由度が高くなります。では、MDX と next-mdx-remote にはどのような関係があるのでしょうか？

next-mdx-remote とは？

next-mdx-remote は名前で推測できるように、Next.js で MDX を使うためのライブラリです。私のブログは Next.js で作られているので、このライブラリを使うことにしました。

next-mdx-remote の README.md にあるコードを参考しながらコードを書くことはあんまり難しくなかったです。でも、next-mdx-remote を使うためには注意点があります。このライブラリを使う前にサーバーサイドレンダリング(SSR)について理解しておくことが重要です。README.md にも書かれていますが、基本的な使用法は、クライアント側では MDXRemoteを使い、サーバー側では serialize を使うことです。サーバー側からデータを持ち込んで、それをクライアント側に渡してMDXRemoteで表示する仕組みです。

Example.jsx

import { serialize } from "next-mdx-remote/serialize";
import { MDXRemote } from "next-mdx-remote";

import Test from "../components/test";

const components = { Test };

export default function TestPage({ source }) {
  return (
    <div className="wrapper">
      <MDXRemote {...source} components={components} />
    </div>
  );
}

export async function getStaticProps() {
  // MDXテキスト - ローカルファイル、データベース、どこからでも取得可能
  const source = "Some **mdx** text, with a component <Test />";
  const mdxSource = await serialize(source);
  return { props: { source: mdxSource } };
}

このようにgetStaticProps()では、サーバー側で MDX テキストを取得し、serialize で変換してクライアント側に渡しています。そして、クライアント側では、MDXRemote で表示しています。しかし、これだけであれば、この README.md を詳しく見ることはなかったでしょう。

こういうと簡単に見えますが、ChatGPT でこれを使いコードの作成をするときに、問題が発生しました。原因は私が Next.js の App Router を使っていることでした。私が App Router に関する質問をしても、ChatGPT はサーバーサイドでMDXRemoteを使うコードを教えてくれ、エラーが発生し続けました。

Next.js の App Router については ChatGPT の理解が浅いので、私が直接 next-mdx-remote の README.md を読むことにしました。App Router の app パスは基本的にサーバーサイドとして扱われるので、MDXRemoteを使うには無理があります。そして、この README.md にはこのように app パスでこのライブラリを利用する場合には、next-mdx-remote/rscを使うように書かれています。結局、いつものように解決方法は公式ドキュメントに書かれていました。

問題を解決した私のコードは以下のようになります。

lib/mdxHelper.ts

import fs from "fs";
import path from "path";
import { compileMDX } from "next-mdx-remote/rsc";
import rehypePrettyCode from "rehype-pretty-code";
import remarkGfm from "remark-gfm";

export function getMdxFileContent(
  lan: string,
  classification: string,
  category: string,
  slug: string
) {
  const filePath = path.join(
    process.cwd(),
    `contents/${lan}/${classification}/${category}/${slug}.mdx`
  );

  const fileContent = fs.readFileSync(filePath, "utf8");
  return fileContent;
}

export async function compileMdxContent(fileContent: string) {
  return await compileMDX({
    source: fileContent,
    options: {
      parseFrontmatter: true,
      mdxOptions: {
        remarkPlugins: [remarkGfm],
        rehypePlugins: [
          [
            rehypePrettyCode,
            {
              theme: "github-light",
            },
          ],
        ],
      },
    },
  });
}

このように Markdown を読み込んで、compileMDXを使ってコンパイルしています。そして、MDXRemoteを使って表示しています。こうやって作成した関数を使って、ページを作成するサーバーサイドコードは以下のようになります。

app/ja/[classification]/[category]/[slug]/page.tsx

import mdxFiles from "@/contents/mdxFiles";
import { notFound } from "next/navigation";
import "github-markdown-css";
import { compileMdxContent, getMdxFileContent } from "@/lib/mdxHelpers";

export default async function Page({
  params,
}: {
  params: {
    classification: string;
    category: string;
    slug: string;
  };
}) {
  const { classification, category, slug } = params;

  const markdownFilePath = `ja/${classification}/${category}/${slug}`;
  const MarkdownComponent = mdxFiles[markdownFilePath];

  if (!MarkdownComponent) {
    notFound();
  }

  const fileContent = getMdxFileContent("ja", classification, category, slug);
  const { content } = await compileMdxContent(fileContent);

  return (
    <div className="flex items-center justify-center min-h-screen">
      <div className="markdown-body w-full md:w-3/5">
        <div className="my-56"></div>
        {content}
        <div className="my-56"></div>
      </div>
    </div>
  );
}

まとめ

next-mdx-remote の README.md でも、個人的な小さいサイトを作るために Next.js 見たいな重いフレームワークを避けることをお勧めしていますが。

データによると、すべての開発者ツールの使用例の 99%は、不必要に複雑な個人ブログを構築することです。冗談です。しかし、真剣に、個人や小規模ビジネス用のブログを構築しようとしている場合は、通常の HTML と CSS を使用することを検討してください。シンプルなブログを作成するために重いフルスタック JavaScript フレームワークを使用する必要は絶対にありません。数年後に更新を行うために戻ってきたとき、すべての依存関係に 10 回の破壊的なリリースがなかったことに感謝するでしょう。

— next-mdx-remote

でも、私はエンジニアとして最新技術にハマる情けない人間なので、仕方ないですね。(泣)

要約すると、next-mdx-remote を使う際には、サーバーサイドとクライアントサイドの違いを理解しておくことが重要です。これを理解しないと、悩まされ続けることになります。Next.js で MDX を使おうとする人には、この投稿が役に立つといいと思います。翻訳はここを参考してください。投稿を読んでくれてありがとうございました。次回はさらに良い記事をお届けします。