Insights

記事の書き方

このサイトに技術記事を追加する手順と、使える Markdown の書き方をまとめたサンプル記事です。

このサイトの記事は、src/content/blog/ に Markdown ファイルを置くだけで公開できます。 この記事自体がサンプルなので、不要になったら削除してください。

記事を追加する手順

  1. src/content/blog/ に my-first-article.md のような半角英数字のファイル名でファイルを作ります(ファイル名がそのまま URL になります)。
  2. ファイルの先頭にフロントマター(記事の情報)を書きます。
  3. 本文を Markdown で書きます。
  4. npm run dev で表示を確認し、GitHub の main ブランチに push します。Cloudflare と Git 連携していれば、自動で公開されます。

フロントマター

---
title: '記事のタイトル'
description: '記事の概要(一覧ページや検索結果に表示されます)'
pubDate: '2026-10-17'
updatedDate: '2026-10-20' # 任意:更新日
tags: ['Astro', 'Cloudflare'] # 任意:タグ
draft: true # 任意:true の間は本番に公開されません
---

Markdown の書き方

見出し・強調・リンク

## 見出し、### 小見出し のように書きます。太字、インラインコード、リンク が使えます。

コードブロック

言語名を付けると、シンタックスハイライトされます。

type Article = {
	title: string;
	tags: string[];
};

export function formatTitle(article: Article): string {
	return `${article.title}(${article.tags.join(', ')})`;
}

表

コマンド 内容
npm run dev 開発サーバーを起動
npm run build 本番用にビルド
npm run deploy Cloudflare に手動でデプロイ

引用・リスト

引用はこのように表示されます。

  • 箇条書き
  • 箇条書き
    • 入れ子にもできます

Contact

データの使い方から、一緒に考えます。

困っていることを、まずはそのままお聞かせください。