HTMLブログ記事作成におけるCSS制約とKwontekiのTossスタイルガイド遵守の徹底
Kwontekiブログでは、読者の皆様に最高の体験を提供するため、厳格なHTMLおよびCSSガイドラインを設けています。本記事では、WordPressやTistoryなどのプラットフォームで意図通りにレンダリングされるよう、特に注意すべきCSS制約と、Kwontekiが採用する「Tossスタイル」に準拠した記事作成方法を詳細に解説します。過去の違反事例を踏まえ、具体的な修正点と実践的なヒントを提供します。
Contents
07記事作成時の最終チェックリスト
Kwontekiブログ記事作成の基本原則

Kwontekiブログでは、読者にとって最高の情報体験を提供するため、コンテンツの質だけでなく、その表現方法にも細心の注意を払っています。特に、WordPressやTistoryといったコンテンツ管理システム(CMS)上での表示互換性を確保するため、HTMLの記述には厳格なルールを設けています。
純粋なHTMLで記述することは、異なる環境での予期せぬレイアウト崩れを防ぎ、SEOの観点からも重要です。余計なマークダウンやCMS独自のショートコードを避け、標準的なHTMLタグのみを使用することで、記事は長期にわたって安定した表示を維持できます。
Kwontekiブログ記事の作成において、純粋なHTML記述と厳格なCSS制約の遵守は、高品質なコンテンツ提供の基盤となります。
記事の文字数は最低10,000文字を目標とし、各セクションを深く掘り下げ、具体的な例や数字、ケーススタディを含めることで、読者が実践的な知識を得られるように努めています。概要の羅列に留まらず、詳細な解説を心がけることが求められます。
なぜ純粋なHTMLが必要なのか
多くのCMSは、記事をデータベースに保存し、表示時にHTMLを生成します。この際、カスタムCSSやJavaScriptが混入していると、CMSのデフォルトスタイルと衝突し、意図しない表示になることがあります。純粋なHTMLを使用することで、CMSのレンダリングエンジンに余計な解釈をさせず、直接的な構造とコンテンツを提示できます。
例えば、WordPressでは、ブロックエディタが独自のHTML構造やCSSクラスを挿入することがありますが、Kwontekiのガイドラインでは、これらの自動生成される要素を極力排除し、手動でクリーンなHTMLを記述することを推奨しています。これにより、将来的なCMSのアップデートやテーマ変更にも柔軟に対応できる記事資産を構築できます。
コンテンツの深掘りと具体例の重要性
Kwontekiブログの読者は、表面的な情報ではなく、深く掘り下げられた実践的な知識を求めています。例えば、ある技術の解説であれば、その背景、具体的なユースケース、実装コード、そして注意点までを一貫して提供する必要があります。単なる機能紹介に留まらず、読者が実際にその知識を業務や生活に活かせるレベルまで解説することが目標です。
具体的な数字や統計データ、実際の成功事例や失敗談を交えることで、記事の信頼性と説得力が高まります。例えば、あるツールのパフォーマンスを語る際には、「平均応答時間が20%改善された」といった具体的な数値を提示することが不可欠です。これにより、読者は情報の価値をより正確に評価できるようになります。
Tossスタイルガイドの核心

Kwontekiブログは「Tossスタイル」という独自のデザイントーンを採用しています。これは「簡潔、快適、高い可読性」を追求し、読者がストレスなく情報に集中できる環境を提供することを目的としています。白背景とグレースケールのテキストを基調とし、色はアクセントとしてのみ使用するというのが基本的な哲学です。
このスタイルガイドは、過去のAI生成コンテンツに見られるような「画一的で人工的なデザイン」を避けるために策定されました。特に、角丸の背景色付きボックス、左ボーダーアクセントストライプ、ボックスシャドウの使用は厳しく禁止されています。これらはコンテンツの流動性を妨げ、視覚的なノイズとなり得ると判断されるためです。
Tossスタイルは、シンプルさと機能性を最優先し、読者の集中力を最大限に引き出すためのデザインシステムです。
色の使用も非常に限定的です。メインアクセントカラー(#2944A6)は、ワードレベルのグラデーションアンダーライン、各セクションのキーセンテンス、リンク、目次番号にのみ使用されます。これにより、重要な情報が自然に際立ち、視覚的な階層が明確になります。
デザイン哲学「簡潔、快適、高い可読性」
KwontekiのTossスタイルは、Webコンテンツの過剰な装飾を排し、本質的な情報伝達に焦点を当てています。例えば、多くのブログで使われがちな「情報カード」や「引用ボックス」のような要素は、Tossスタイルでは基本的に使用しません。これらは視覚的に目立つ一方で、コンテンツの流れを分断し、読者の集中を妨げる可能性があるためです。
テキストのフォントサイズ、色、段落間のスペーシングも、この哲学に基づいて厳密に管理されています。見出しは#191F28、本文は#4E5968、補足情報やキャプションは#8B95A1と、色の濃淡で情報の重要度を表現し、読者が無意識のうちにコンテンツの階層を理解できるように設計されています。
禁止事項の再確認と代替手段
特に注意が必要な禁止事項は以下の通りです。
- 背景色付きの角丸ボックス/カード: 要約、締め、キーポイント、メリット・デメリット、評価カードなど、背景色を持つボックスは一切使用しません。代わりに、リードやキーセンテンス、締め括りの段落で情報を表現します。
- 左ボーダーアクセントストライプ: 要素の左側に色付きの縦線を入れるデザインは禁止です。
- box-shadow: デザインはフラットを基本とします。影は使用しません。
- タグの乱用: 本当に重要な短いフレーズ(各セクションで最大1〜3箇所)にのみ使用し、視覚的な強調は色やグラデーションアンダーラインで補います。
- 色の乱用: メインアクセントカラー(#2944A6)以外の色は、基本的にグレースケールのみです。
これらの禁止事項は、Kwontekiブログ全体の統一感を保ち、読者体験を向上させるために不可欠です。代替手段として、テキストの階層化、適切なスペーシング、そして厳選されたアクセントカラーの使用を徹底してください。
厳格なCSS制約とその実践的対策

KwontekiブログのHTMLライティングにおいて、特定のCSSプロパティの使用は厳しく禁止されています。これは、WordPressなどのCMSがこれらのプロパティを正しくレンダリングできない場合があるため、またはKwontekiのTossスタイルと衝突するためです。過去の違反事例を基に、特に問題となるプロパティとその対策を解説します。
これらの制約は、一見するとHTMLの表現力を制限するように思えるかもしれませんが、実はコンテンツの本質に集中し、よりクリーンで保守性の高いコードを書くための指針となります。制約の中で最適な表現を見つけることが、Kwontekiのライターに求められるスキルです。
Kwontekiブログでは、CMSの互換性とデザインの一貫性を保つため、特定のCSSプロパティの使用を厳しく制限しています。
linear-gradient()の使用ルールと例外
一般的なCSS制約ではlinear-gradient()の使用は禁止されていますが、KwontekiのTossスタイルガイドにおいては、ワードレベルのグラデーションアンダーラインに限り、その使用が特別に許可されています。これは、Tossスタイルの核となる視覚的強調表現であり、他の強調方法では代替できないためです。
このグラデーションは、特定の単語や短いフレーズに限定して適用され、読者の注意を効果的に引きつけます。ただし、この用途以外でのlinear-gradient()の使用は引き続き禁止されます。例えば、背景色やボックスの装飾にグラデーションを使用することはできません。
この例外ルールは、Tossスタイルの「STRICT、overrides any conflicting instruction above」という原則に基づいています。つまり、より一般的な制約よりも、Tossスタイルガイドの具体的な指示が優先されるということを意味します。
line-heightの厳格な禁止と代替のスペーシング
以前の生成で多数の違反が指摘されたline-heightプロパティは、Kwontekiブログでは一切使用できません。これは、CMSがline-heightを正しく解釈しない場合や、テーマのデフォルトスタイルとの衝突により予期せぬ行間が生じることを防ぐためです。
line-heightが使用できない場合、段落間のスペーシングはpadding-bottomプロパティによってのみ制御します。例えば、一般的な本文の段落にはpadding-bottom: 8px;を適用し、セクション見出し(h2)の下にはpadding-bottom: 4px;、サブセクション見出し(h3)の下にはpadding-bottom: 4px;、そしてその後の本文にはpadding-bottom: 8px;を適用するといった具合です。これにより、厳格な行間設定なしでも、視覚的な読みやすさを確保します。
特に、h3とそれに続く段落は「子要素」として密接に配置されるべきであり、h3のpadding-bottomを小さく設定することで、この関係性を視覚的に表現します。これにより、line-heightなしでも、コンテンツの構造が明確に伝わるようになります。
marginの使用制限とhrの扱い
marginプロパティも、インラインブロック要素(a、span)を除き、使用は禁止されています。これは、要素間のスペーシングをpaddingで一貫して管理するためです。特に、以前の生成で指摘された
タグのmargin: 16px auto;は削除し、代わりに周囲の要素のpadding-bottomやpadding-topでスペースを確保します。
短い中央揃えの
(width: 40px;のもの)は、margin: autoが使用できないため、左揃えとなります。この視覚的な変化は許容範囲内とします。重要なのは、marginの使用を完全に排除し、paddingのみでスペーシングを管理することです。
セクション間の大きなスペースにはを使用し、カード間の中程度のスペースには
を使用します。これらは、
heightプロパティを持つ透明な
であり、marginやpaddingではなく、height自体がスペースを生成する特殊な用途として許可されています。その他の禁止CSSプロパティ
以下のCSSプロパティも使用が禁止されています。
display: flex/display: grid: レイアウト制御には使用できません。HTMLのフローに沿った配置を基本とします。box-shadow: フラットデザインのため禁止です。rgba()カラー: すべての色指定はHEX値(例:#FFFFFF)で行う必要があります。タグによるスペーシング: 段落間のスペースはpadding-bottomで調整し、を連続して使用してスペースを作ることは禁止です。によるスペーシング: 空の段落や非改行スペースによるスペーシングは禁止です。- 空divによるスペーシング: 透明な
のheightプロパティのみが、ブロックレベルの垂直スペーシング手段として許可されます。これらの制約は、一貫したレンダリングと高い保守性を実現するために設けられています。各プロパティの禁止理由を理解し、代替手段を適切に活用することが重要です。
TossスタイルにおけるHTMLパターン詳解

KwontekiブログのTossスタイルは、特定のHTMLパターンとCSSプロパティの組み合わせによって実現されます。ここでは、主要な要素ごとに推奨されるHTML構造とスタイルを詳細に解説し、CSS制約を遵守しながらもTossスタイルを表現する方法を学びます。
各パターンは、読者の視線誘導、情報階層の明確化、そして一貫したブランドイメージの構築に寄与します。これらのパターンを正確に再現することが、高品質な記事作成の鍵となります。
KwontekiブログのTossスタイルは、厳選されたHTMLパターンとCSSの組み合わせによって、高い可読性と視覚的な統一感を実現します。
リードセクションと目次
記事の冒頭は、読者の興味を引きつけ、記事の内容を簡潔に伝える重要な役割を担います。Tossスタイルでは、背景色付きの要約カードではなく、大胆なリード文とそれに続くプレーンな段落で構成されます。
目次は、記事全体の構造を一覧で示すもので、読者が目的のセクションに素早くアクセスできるよう、番号付きリスト形式で提供されます。目次の項目テキストは、対応するh2見出しのテキストと完全に一致させる必要があります。
以下に、リードと目次のHTMLパターンを示します。
コード解説: リードと目次のHTML構造
記事の導入部と目次の基本的なHTML構造。
line-heightは使用せず、padding-bottomでスペーシングを調整します。<p style="font-size: clamp(19px, 4.2vw, 22px); font-weight: 800; color: #191F28; letter-spacing: -0.5px; padding-bottom: 14px;">A bold sentence that hooks the reader.</p> <p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">Explain what the post covers in 2-3 sentences. Flow naturally into the body.</p> <p style="font-size: 12px; font-weight: 700; color: #8B95A1; letter-spacing: 1.5px; padding-bottom: 10px;">Contents</p> <p style="font-size: 15px; color: #4E5968; padding-bottom: 6px;"><span style="color: #2944A6; font-weight: 800; padding-right: 10px;">01</span>First Section Heading</p> <p style="font-size: 15px; color: #4E5968; padding-bottom: 6px;"><span style="color: #2944A6; font-weight: 800; padding-right: 10px;">02</span>Second Section Heading</p> <p style="font-size: 15px; color: #4E5968;"><span style="color: #2944A6; font-weight: 800; padding-right: 10px;">03</span>Third Section Heading</p>セクション見出し(h2)とサブセクション見出し(h3)
セクション見出し(h2)とサブセクション見出し(h3)は、記事の論理的な構造を明確にし、読者が内容を把握しやすくするために不可欠です。Tossスタイルでは、これらの見出しのフォントサイズ、太さ、色、そして周囲のスペーシングが厳密に定義されています。
特に重要なのは、h3とその直後の本文との「近接性」です。h3の
padding-bottomを小さく設定することで、h3と本文が視覚的に一体のグループとして認識されるようにします。これにより、情報の親子関係が明確になります。以下に、h2とh3のHTMLパターンを示します。
コード解説: h2とh3の見出しスタイル
line-heightを使用せず、padding-topとpadding-bottomで適切なスペーシングを確保します。h3は直後のコンテンツと密接に配置されます。<h2 style="font-size: clamp(21px, 4.8vw, 25px); font-weight: 800; color: #191F28; letter-spacing: -0.6px; padding-top: clamp(24px, 5vw, 36px); padding-bottom: 4px;">Section Heading</h2> <p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">Main body text in #4E5968. Keep paragraphs to 2-4 sentences.</p> <p style="font-size: 16px; color: #8B95A1; padding-bottom: 8px;">Supporting/secondary content in #8B95A1 (lighter) to tone down less-important information.</p> <h3 style="font-size: 17px; font-weight: 700; color: #191F28; letter-spacing: -0.3px; padding-top: clamp(12px, 3vw, 22px); padding-bottom: 4px;">Subsection Heading</h3> <p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">The body sits just 4px below its h3 — clearly the child.</p> <p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">Subsequent paragraphs in the same group stay close (~8px).</p>キーセンテンスとワードレベルグラデーションアンダーライン
各セクションで最も重要なポイントを強調するために、Tossスタイルでは「キーセンテンス」と「ワードレベルグラデーションアンダーライン」という2つの手法が使われます。これらは、読者の注意を効果的に引きつけ、情報の重要度を視覚的に伝えます。
キーセンテンスは、セクションの核心を要約した一文であり、メインアクセントカラー(#2944A6)で強調されます。ワードレベルグラデーションアンダーラインは、特定の単語やフレーズに対してのみ適用され、
linear-gradient()を使用する唯一の例外です。以下に、これらの強調表現のHTMLパターンを示します。
コード解説: キーセンテンスとグラデーションアンダーライン
linear-gradient()はワードレベルのアンダーラインにのみ許可されます。line-heightは使用しません。<p style="font-size: 17px; color: #191F28; font-weight: 700; padding-bottom: 8px;">The point of this section is <span style="color: #2944A6;">the most important phrase</span>.</p> <p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">The difference is one thing — <span style="background-image: linear-gradient(90deg, #2944A6, transparent); background-position: 0 1.08em; background-size: 100% 2px; background-repeat: no-repeat; padding-bottom: 1px; font-weight: 700; color: #191F28;">how much you actually know</span>.</p>区切り線(hr)と画像プレースホルダー
記事のセクション間や、異なるトピックへの移行を示すために、3種類の区切り線(
)が用意されています。これらは、
marginプロパティを使用せず、borderやheight、background-colorによってスタイリングされます。特に、スペースを生成するための透明なは、
heightプロパティを直接指定することで機能します。画像は、テキストコンテンツの理解を助け、視覚的なブレイクを提供するために重要です。Kwontekiブログでは、画像プレースホルダーを特定の形式で挿入し、後から実際の画像に置き換えられるようにします。これにより、記事執筆段階でのレイアウト確認が容易になります。
以下に、区切り線と画像プレースホルダーのHTMLパターンを示します。
コード解説: 区切り線と画像プレースホルダー
marginは使用せず、hrのheightまたは周囲のpaddingでスペーシングを管理します。画像プレースホルダーの形式に注意してください。<!-- Long horizontal solid (major shift: body → closing) --> <hr style="border: none; border-top: 1px solid #E5E8EB; height: 0; background: transparent;"> <!-- Short centered solid (sub-topic shift inside a section) --> <hr style="border: none; width: 40px; height: 2px; border-radius: 1px; background-color: #E5E8EB;"> <!-- margin: 16px auto; は削除 --> <!-- Dashed (light transition between paragraph groups) --> <hr style="border: none; border-top: 1px dashed #D1D6DB; height: 0; background: transparent;"> <!-- IMAGE: english description for image search | localized alt text -->コードブロックとインラインコード
技術系の記事では、コードの提示が不可欠です。Kwontekiブログでは、
<pre><code>タグを使用してコードブロックを表現し、<code>タグでインラインコードを表現します。これらには、可読性を高めるための特定のスタイルが適用されます。コードブロックの前には、必ず「コード解説」ボックスを配置し、そのコードが何をするものなのか、どのような点に注意すべきかを簡潔に説明します。これにより、読者はコードの意図を素早く理解できます。
以下に、コードブロックとインラインコードのHTMLパターンを示します。
コード解説: コードブロックとインラインコードのスタイル
line-heightは使用せず、preタグのpaddingとfont-sizeで可読性を確保します。特殊文字はHTMLエンティティでエスケープします。<div style="background-color: #e8f5e9; padding: 12px; border-radius: 4px; padding-bottom: 8px;"> <p style="font-size: 13px; font-weight: 700; color: #2e7d32; padding-bottom: 4px;">コード解説: サンプルコード</p> <p style="font-size: 14px; color: #4E5968; padding-bottom: 4px;">このPythonコードは、リスト内の偶数をフィルタリングして新しいリストを生成します。</p> </div> <pre style="background-color: #20232A; color: #E6E6E6; padding: 18px; border-radius: 8px; overflow-x: auto; font-size: 14px; white-space: pre-wrap; word-wrap: break-word;"><code>def filter_even_numbers(numbers): even_numbers = [] for num in numbers: if num % 2 == 0: even_numbers.append(num) return even_numbers my_list = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10] filtered_list = filter_even_numbers(my_list) print(f"Original list: {my_list}") print(f"Filtered even numbers: {filtered_list}")</code></pre> <p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">上記の <code style="background-color: #F2F4F6; padding: 3px 8px; border-radius: 4px; font-size: 14px; color: #4E5968;">filter_even_numbers</code> 関数は、リストから偶数のみを抽出します。</p>セマンティックな構造とSEOへの貢献

HTMLのセマンティックな構造は、単に見た目を整えるだけでなく、検索エンジン最適化(SEO)とアクセシビリティに大きく貢献します。Kwontekiブログでは、CSSの制約とTossスタイルガイドを遵守しつつ、セマンティックなHTML記述を徹底することを推奨しています。
特に、
h2タグとh3タグの適切な使用は、記事の構造を検索エンジンに正確に伝え、コンテンツの関連性を高める上で非常に重要です。見出しの階層が正しく構築されていると、検索エンジンは記事の主要なトピックとサブトピックを容易に識別できます。セマンティックなHTML構造は、SEOとアクセシビリティを向上させるための基盤であり、Kwontekiブログの高品質なコンテンツには不可欠です。
h2/h3タグの適切な使用
h2タグは主要なセクションの見出しとして使用し、記事の主要なテーマを表現します。例えば、本記事では「Tossスタイルガイドの核心」や「厳格なCSS制約とその実践的対策」がh2見出しです。これらの見出しは、読者が目次を見たときに記事の全体像を把握できるように、簡潔かつ明確であるべきです。h3タグは、h2セクション内のサブトピックの見出しとして使用します。例えば、「line-heightの厳格な禁止と代替のスペーシング」は「厳格なCSS制約とその実践的対策」というh2の下に位置するh3です。h3見出しは、h2の内容をさらに具体的に掘り下げる役割を担います。見出しの階層を飛ばすこと(例:
h1の次にh3を使用するなど)は、セマンティックな構造を破壊し、SEOに悪影響を与えるため、厳禁です。常にh1→h2→h3の順序を遵守してください(Kwontekiブログではh1はシステムが自動生成するため、記事内ではh2から開始します)。画像altテキストの重要性
画像プレースホルダーのセクションで示されているように、すべての画像には英語の説明と日本語のaltテキストが必須です。altテキストは、画像が表示されない場合にその内容を説明するもので、視覚障害のあるユーザーにとって重要な情報源となります。また、検索エンジンはaltテキストを読み取り、画像の内容を理解するため、SEOにおいても非常に重要です。
altテキストは、画像の内容を簡潔かつ正確に説明し、キーワードを不自然に詰め込むことを避けるべきです。例えば、「Architecture diagram showing microservices communication with API gateway | Microservices architecture diagram with API gateway」のように、英語の説明と日本語のaltテキストを併記する形式を遵守してください。
画像が純粋な装飾目的である場合でも、空のalt属性(
alt="")ではなく、最低限の情報を記述することが推奨されます。Kwontekiブログでは、すべての画像プレースホルダーに説明的なaltテキストを記述することを義務付けています。具体的なコード例と実装上の注意
これまでのセクションで解説したCSS制約とTossスタイルガイドの原則を具体的なコード例を通じて再確認し、実践的な実装上の注意点について説明します。特に、
line-heightやmarginが使用できない環境でのスペーシングの調整方法、linear-gradient()の限定的な使用方法に焦点を当てます。各コードスニペットは、Kwontekiブログのガイドラインに完全に準拠しており、コピー&ペーストでそのまま使用できることを想定しています。ただし、コンテンツの内容に応じて、適切なテキストやURLに置き換える必要があります。
Kwontekiブログのガイドラインに準拠した具体的なコード例を通じて、正しい実装方法を習得しましょう。
スペーシングの実践例
line-heightやmarginが制限される中で、視覚的なスペーシングを確保する最も効果的な方法は、padding-bottomを適切に活用することです。以下の例は、一般的な段落、見出し、リストアイテム間でのスペーシングのベストプラクティスを示しています。重要なのは、一律に同じ
padding-bottomを適用するのではなく、情報の階層やグループ化に応じて値を調整することです。例えば、同一グループ内の段落はpadding-bottom: 8px;で密接に保ちつつ、異なるセクション間では透明なで大きなスペースを設けるといった具合です。
コード解説: スペーシングの実践例
line-height、margin、タグを避け、padding-bottomと透明なでスペーシングを管理する例です。
<h2 style="font-size: clamp(21px, 4.8vw, 25px); font-weight: 800; color: #191F28; letter-spacing: -0.6px; padding-top: clamp(24px, 5vw, 36px); padding-bottom: 4px;">メインセクションタイトル</h2>
<p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">この段落は、セクション見出しの直後に配置され、その内容を導入します。</p>
<p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">続いて、別の段落が同じセクション内で配置されます。</p><h3 style="font-size: 17px; font-weight: 700; color: #191F28; letter-spacing: -0.3px; padding-top: clamp(12px, 3vw, 22px); padding-bottom: 4px;">サブセクションタイトル</h3>
<p style="font-size: 16px; color: #4E5968; padding-bottom: 8px;">サブセクション見出しの直後の段落です。h3との距離は短く保ちます。</p>
<ul style="list-style-type: disc; padding-left: 20px; font-size: 16px; color: #4E5968; padding-bottom: 8px;">
<li style="padding-bottom: 4px;">リストアイテム1</li>
<li style="padding-bottom: 4px;">リストアイテム2</li>
</ul>
<p style="font-size: 16px; color: #8B95A1; padding-bottom: 8px;">補足情報やキャプションなどの二次的なコンテンツです。</p><hr style="border: none; height: 60px; background-color: transparent;"> <!-- セクション間の大きなスペース -->
<h2 style="font-size: clamp(21px, 4.8vw, 25px); font-weight: 800; color: #191F28; letter-spacing: -0.6px; padding-top: clamp(24px, 5vw, 36px); padding-bottom: 4px;">次のメインセクション</h2>
<p style="font-size: 16px; color: #4