String Functions

Functions for text manipulation and formatting.

Case Conversion

lower

Convert to lowercase.

{{ lower "HELLO" }}  // Output: hello
{{ lower .Title }}

upper

Convert to uppercase.

{{ upper "hello" }}  // Output: HELLO
{{ upper .Acronym }}

String Checks

contains

Checks if substring is in string.

{{ contains "needle" "needle in hay" }}  // Output: true
{{ if contains .Content "TODO" }}
  <span>Has TODO</span>
{{ end }}

has_prefix / starts_with

Checks if string starts with a prefix. starts_with is an alias.

{{ has_prefix "hello world" "hello" }}  // Output: true
{{ starts_with "hello world" "hello" }}  // Output: true

has_suffix / ends_with

Checks if string ends with a suffix. ends_with is an alias.

{{ has_suffix "hello world" "world" }}  // Output: true
{{ ends_with "hello world" "world" }}  // Output: true

String Manipulation

replace

Replaces all occurrences of a substring.

{{ replace "hello world" "world" "gopher" }}  // Output: hello gopher

split

Split string into slice.

{{ split "a,b,c" "," }}  // Output: [a b c]
{{ range split .Tags "," }}
  <span>{{ . }}</span>
{{ end }}

join

Join slice into string.

{{ join (split "a,b,c" ",") "-" }}  // Output: a-b-c
{{ join .Tags ", " }}

trim

Removes leading and trailing whitespace.

{{ trim "  hello  " }}  // Output: hello

urlize

Converts string to URL-friendly format.

{{ urlize "Hello World!" }}  // Output: hello-world
{{ urlize .Title }}

Examples

URL Detection

{{ $url := .Permalink }}
{{ if or (starts_with $url "http://") (starts_with $url "https://") }}
  <a href="{{ $url }}" target="_blank">External</a>
{{ end }}

File Extension Check

{{ if ends_with .File ".pdf" }}
  <span>📄 PDF</span>
{{ else if ends_with .File ".zip" }}
  <span>📦 ZIP</span>
{{ end }}

Tag Processing

{{ range split .Tags "," }}
  <a href="/tags/{{ urlize . }}">{{ trim . }}</a>
{{ end }}