📘 公式リファレンス🔧 リファレンス/フィルター初級

newline_to_br フィルター（改行をHTML改行に変換）

文字列内の改行(\n)を HTML の <br> タグに変換するフィルター。複数行テキストをストア上で行を崩さずに表示する。

用途

商品説明や記事本文など、改行を含むテキストを Liquid で出力するとき。管理画面で入力した改行がそのままストア上に反映される。

設置場所

商品ページ・コレクション・ブログ記事など任意のテンプレート内で、`{{ product.description | newline_to_br }}` の形で改行を含むテキストフィールドに対して直接フィルターを適用する。

注意点

HTML エスケープが必要な特殊文字(<、>、&)は自動変換されないため、`newline_to_br` 適用後に必要に応じて `escape` フィルターを組み合わせる（例: `{{ text | newline_to_br | escape }}`）。ユーザー入力テキストで XSS リスクがある場合は `escape` を先に実行してから `newline_to_br` を適用することで安全性を高める。

タグ:filterstringhtmlformatting

仕様

30 行 / json

{
  "category": "string",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "",
  "parameters": [],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/products/health-potion",
      "raw_liquid": "{{ product.description | newline_to_br }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Converts newlines (`\\n`) in a string to HTML line breaks (`&lt;br&gt;`).",
  "syntax": "string | newline_to_br",
  "name": "newline_to_br"
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/filters.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

このコードは Shopify 著作の MIT ライセンスソースです。原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

newline_to_br フィルター（改行をHTML改行に変換）

仕様

出典・ライセンス

関連項目

avatar フィルター（顧客アバター画像HTML生成）

default_errors フィルター（フォーム送信エラーを日本語化）

date フィルター（日付を指定形式でフォーマット）

payment_terms フィルター（Shop Pay分割払いバナーを生成）

abs フィルター（数値の絶対値を取得）

append フィルター（文字列の末尾に追加）