Y
Zenn記事を標準フォーマットで素早く始められる
by y16ra
新しい記事ファイルを自動生成できる npx zenn new:article または make new-article コマンドで、テンプレート付きの記事ファイルをすぐに作成できます。 フロントマターを正しく設定できる タイトル・絵文字・記事タイプ(tech/idea)・タグ・公開設定など、Zenn投稿に必要なメタデータを CLAUDE.md の記事フォーマットに合わせて一度に設定できます。 シリーズ記事の関連付けが簡単にできる 続編記事では親記事へのリンクを自動挿入でき、読者が前の記事から流れよく読める構成にできます。 執筆中のテキスト品質を自動チェックできる textlint で日本語の統一性(です/ます、である/だ)や技術用語の表記ゆれを自動検出し、そのまま投稿できる状態に整備できます。 記事特有の記法・構文を素早く確認できる Zenn独特のメッセージブロック・mermaid図表などの記法を、同リポジトリの zenn-markdown スキルで参照しながら正しく書けます。 このリポジトリで定期的に技術記事やアイデア記事を執筆する人 複数の記事をシリーズ化して投稿したい人 textlint による品質チェックを挟んで、公開前の修正作業を効率化したい人 Zennの記事フォーマットや記法をいちいち調べずに、テンプレートに従って書きたい人 Zenn新規記事作成の一貫ガイド。記事ファイルはリポジトリ直下で npx zenn new:article または make new-article で生成し、既存記事と同じ形式の articles/.md ファイルを使用(カスタムslugは不要)。フロントマターは CLAUDE.md のArticle Formatに従い、title(引用符囲み)、emoji(1文字の絵文字)、type(tech または idea)、topics(英小文字タグ配列:aws, 資格, aifc01など)、published(下書き時false、公開時true and published_at JST任意)を設定。本文見出しは ## から始める(# は使用禁止)。シリーズ続編の場合、「はじめに」で親記事へリンク([タイトル](/articles/) 形式、slugはファイル名から.md除去)。記法・メッセージブロック・mermaid図は zenn-markdown スキルを参照。執筆中は日本語を「です/ます」か「である/だ」のいずれかに統一し、textlintの no-mix-dearu-desumasu ルールに従う。用語が引っかかる場合は .textlintrc のallowlistか、ブロック単位での無効化コメント(`)で最小限対処。保存前に npx textlint articles/.md または make textlint-articles`(全体チェック)を実行。
記事