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

個人メディアに静的サイトが合う理由
ブログやメディアのページは、読者が開くたびに内容が変わるわけではありません。それなら、公開する前に全ページを HTML にしておき、サーバーはファイルを返すだけにしたほうが、速くて壊れにくくなります。これが静的サイトの考え方です。
Astro は、この静的な出力が標準の設定です。公式の設定リファレンスでも、output の初期値は static で、すべてのページを事前に書き出すと説明されています。データベースもサーバー側のプログラムもいらないので、ひとりで運営するときに守るものが減ります。
DE:ZIGN も、2026年11月に PHP と SQLite の構成から Astro に移しました。記事が50本を超えていても、ビルドは数秒で終わります。
記事は「コンテンツコレクション」にまとめる
記事のように、同じ形のデータがたくさんあるものを、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 };
---
title: Astro でメディアを始めました
description: 最初の記事です
pubDate: 2026-11-14
---
本文は Markdown で書きます。
schema を書いておくと、title を書き忘れた記事があればビルドの時点でエラーになります。記事が増えるほど、この安全装置のありがたみが分かってきます。
公式ドキュメントは、コレクションを使う利点のひとつとして、import.meta.glob() の代わりに getCollection() のような記事向けの関数で問い合わせできることを挙げています。
記事ページと一覧ページを作る
記事ページは、1つのファイル [id].astro から、記事の数だけ HTML を書き出します。どの URL を作るかは getStaticPaths() で 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 になるので、最初から英小文字とハイフンで付けておくと迷いません。
---
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 など |
| trailingSlash | URL の最後に「/」を付けるか | 'always'(付ける)/'never'(付けない)/'ignore'(どちらでも。初期値) |
| build.format | HTML の書き出し方 | 'directory'(posts/hello/index.html。初期値)/'file'(posts/hello.html)/'preserve' |
出典:Astro 設定リファレンス(2026年11月14日に確認)
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/記事名/ の形)を変えずに引っ越す必要があったので、末尾スラッシュあり・フォルダ形式にそろえました。新しく始めるなら、どちらを選んでも構いません。決めたら変えないことのほうが大切です。
デモの id の変換は説明用に単純化しています。実際の変換規則は Astro の実装に従います。
既存の HTML を引き継ぐときの別の道
ここまでは Markdown で書く前提でした。DE:ZIGN の場合は、PHP 時代に書いた記事が、デモやスタイルを含んだ HTML として50本以上ありました。これを Markdown に書き直すのは現実的ではありません。
そこで、記事を src/content/articles/カテゴリ/記事名.html という HTML ファイルとして置き、先頭に YAML でタイトルや公開日を書く形にしました。読み込みは import.meta.glob() で文字列として読み、自前の関数で項目と本文に分けています。
コンテンツコレクションの型チェックはその分なくなるので、タイトルがない記事は自前でエラーにしています。新しく始めるなら、公式が勧めるコンテンツコレクションを選んでください。既存の資産があるときは、こうした抜け道もある、という程度に覚えておくと役に立ちます。
まとめ
- Astro は静的な出力が初期設定で、全ページをビルドの時点で HTML にするため、個人メディアの運営で守るものが少ない。
- 記事は src/content.config.ts でコンテンツコレクションとして定義し、glob で読み、schema で項目を決める。
- 記事ページは [id].astro の getStaticPaths() で getCollection() を呼び、render() で本文を表示する。
- glob で読んだ記事の id はファイル名から作られるので、ファイル名は英小文字とハイフンで付ける。
- site・trailingSlash・build.format は最初の記事を出す前に決め、公開後は変えない。
- 既存の HTML 記事を引き継ぐなら、import.meta.glob() で読む方法もあるが、新規ならコンテンツコレクションを使う。
参考・出典
- Astro Docs:Content collections 2026年11月14日確認
- Astro Docs:Content Loader API(glob ローダー) 2026年11月14日確認
- Astro Docs:設定リファレンス(site・trailingSlash・build.format・output) 2026年11月14日確認