「Astroで個人メディアを作る」記事の置き方と静的出力の基本

Astro は、ページをビルドの時点で HTML に書き出す静的サイトを得意とするフレームワークです。記事を Markdown で置き、一覧と記事ページを作り、URL とサイトマップを整えるところまでを、最小の構成で組み立てます。

個人メディアに静的サイトが合う理由

ブログやメディアのページは、読者が開くたびに内容が変わるわけではありません。それなら、公開する前に全ページを HTML にしておき、サーバーはファイルを返すだけにしたほうが、速くて壊れにくくなります。これが静的サイトの考え方です。

Astro は、この静的な出力が標準の設定です。公式の設定リファレンスでも、output の初期値は static で、すべてのページを事前に書き出すと説明されています。データベースもサーバー側のプログラムもいらないので、ひとりで運営するときに守るものが減ります。

DE:ZIGN も、2026年11月に PHP と SQLite の構成から Astro に移しました。記事が50本を超えていても、ビルドは数秒で終わります。

記事は「コンテンツコレクション」にまとめる

記事のように、同じ形のデータがたくさんあるものを、Astro ではコンテンツコレクションとして扱います。設定ファイル src/content.config.ts に「どこにあるファイルを」「どんな項目で」読むかを書きます。

my-media/ ├── astro.config.mjs └── src/ ├── content.config.ts ← コレクションの定義 ├── content/ │ └── posts/ │ ├── hello-astro.md │ └── second-post.md └── pages/ ├── index.astro ← 記事一覧 └── posts/ └── [id].astro ← 記事ページ
src/content.config.ts
import { defineCollection } from 'astro:content';
import { glob } from 'astro/loaders';
import { z } from 'astro/zod';

const posts = defineCollection({
  // src/content/posts の .md をすべて読む
  loader: glob({ base: './src/content/posts', pattern: '**/*.md' }),
  // 先頭の項目(フロントマター)の形を決める
  schema: z.object({
    title: z.string(),
    description: z.string(),
    pubDate: z.coerce.date(),
    draft: z.boolean().default(false),
  }),
});

export const collections = { posts };
src/content/posts/hello-astro.md
---
title: Astro でメディアを始めました
description: 最初の記事です
pubDate: 2026-11-14
---

本文は Markdown で書きます。

schema を書いておくと、title を書き忘れた記事があればビルドの時点でエラーになります。記事が増えるほど、この安全装置のありがたみが分かってきます。

公式ドキュメントは、コレクションを使う利点のひとつとして、import.meta.glob() の代わりに getCollection() のような記事向けの関数で問い合わせできることを挙げています。

記事ページと一覧ページを作る

記事ページは、1つのファイル [id].astro から、記事の数だけ HTML を書き出します。どの URL を作るかは getStaticPaths() で Astro に伝えます。

src/pages/posts/[id].astro
---
import { getCollection, render } from 'astro:content';

export async function getStaticPaths() {
  // 下書き(draft: true)は書き出さない
  const posts = await getCollection('posts', ({ data }) => !data.draft);
  return posts.map((post) => ({ params: { id: post.id }, props: { post } }));
}

const { post } = Astro.props;
const { Content } = await render(post);
---
<article>
  <h1>{post.data.title}</h1>
  <Content />
</article>

post.id は、glob で読んだ場合はファイル名から自動で作られます。公式ドキュメントによると URL に使いやすい形に変換され、大文字は小文字になります。hello-astro.md なら /posts/hello-astro/ です。ファイル名がそのまま URL になるので、最初から英小文字とハイフンで付けておくと迷いません。

src/pages/index.astro(新しい順の一覧)
---
import { getCollection } from 'astro:content';
const posts = (await getCollection('posts', ({ data }) => !data.draft))
  .sort((a, b) => b.data.pubDate.getTime() - a.data.pubDate.getTime());
---
<ul>
  {posts.map((p) => <li><a href={`/posts/${p.id}/`}>{p.data.title}</a></li>)}
</ul>

URL の形はあとから変えにくい。最初に決める

公開してから URL を変えると、検索エンジンの評価やほかのサイトからのリンクが切れます。astro.config.mjs の次の3つは、最初の記事を出す前に決めておきます。

設定決めること選べる値
site公開するサイトの URL。サイトマップと canonical(正規の URL)の生成に使われるhttps://example.com など
trailingSlashURL の最後に「/」を付けるか'always'(付ける)/'never'(付けない)/'ignore'(どちらでも。初期値)
build.formatHTML の書き出し方'directory'(posts/hello/index.html。初期値)/'file'(posts/hello.html)/'preserve'

出典:Astro 設定リファレンス(2026年11月14日に確認)

astro.config.mjs(DE:ZIGN の設定と同じ組み合わせ)
import { defineConfig } from 'astro/config';
import sitemap from '@astrojs/sitemap';

export default defineConfig({
  site: 'https://dezign.jp',
  trailingSlash: 'always',
  build: { format: 'directory' },
  integrations: [sitemap()],
});

DE:ZIGN は、PHP 時代の URL(/tips/記事名/ の形)を変えずに引っ越す必要があったので、末尾スラッシュあり・フォルダ形式にそろえました。新しく始めるなら、どちらを選んでも構いません。決めたら変えないことのほうが大切です。

▶ Live Demo — 設定によって URL と出力ファイルがどう変わるか

デモの id の変換は説明用に単純化しています。実際の変換規則は Astro の実装に従います。

既存の HTML を引き継ぐときの別の道

ここまでは Markdown で書く前提でした。DE:ZIGN の場合は、PHP 時代に書いた記事が、デモやスタイルを含んだ HTML として50本以上ありました。これを Markdown に書き直すのは現実的ではありません。

そこで、記事を src/content/articles/カテゴリ/記事名.html という HTML ファイルとして置き、先頭に YAML でタイトルや公開日を書く形にしました。読み込みは import.meta.glob() で文字列として読み、自前の関数で項目と本文に分けています。

コンテンツコレクションの型チェックはその分なくなるので、タイトルがない記事は自前でエラーにしています。新しく始めるなら、公式が勧めるコンテンツコレクションを選んでください。既存の資産があるときは、こうした抜け道もある、という程度に覚えておくと役に立ちます。

💡 公開先
書き出した dist フォルダは、HTML を置けるところならどこでも公開できます。DE:ZIGN は Cloudflare Workers に置いています。手順は「Cloudflare Workers で静的サイトと小さな API を公開する」にまとめました。

まとめ

  • Astro は静的な出力が初期設定で、全ページをビルドの時点で HTML にするため、個人メディアの運営で守るものが少ない。
  • 記事は src/content.config.ts でコンテンツコレクションとして定義し、glob で読み、schema で項目を決める。
  • 記事ページは [id].astro の getStaticPaths() で getCollection() を呼び、render() で本文を表示する。
  • glob で読んだ記事の id はファイル名から作られるので、ファイル名は英小文字とハイフンで付ける。
  • site・trailingSlash・build.format は最初の記事を出す前に決め、公開後は変えない。
  • 既存の HTML 記事を引き継ぐなら、import.meta.glob() で読む方法もあるが、新規ならコンテンツコレクションを使う。

参考・出典