newline

The newline keyword literal represents the newline control character: \n. It's useful for navigating or assembling strings.

Filter support

Besides its natural uses in building strings, newline has a special purpose within these string filters:

• newline_to_br – When used with newline, this filter will replace instances of "\r\n", and then instances of "\n".

• replace – When used with newline as its first argument, this filter will replace instances of "\r\n", and then instances of "\n".

• split – When used with newline, this filter will split by "\r\n" when present, and then by "\n".

Under the hood, each of these scenarios uses the regular expression /\r?\n/.

Example

{% assign message = "Hello!" | append: newline | append: newline %}
{% assign message = message | append: "This is a new paragraph!" %}

{% capture lines %}
foo
bar
baz
{% endcapture %}

{% assign words = lines | split: newline %}
{% assign tags = lines | replace: newline, ", " %}