mirror of
https://github.com/gohugoio/hugo.git
synced 2024-12-01 20:15:50 -05:00
24 lines
1.2 KiB
Markdown
24 lines
1.2 KiB
Markdown
---
|
|
title: anchorize
|
|
description: Takes a string and sanitizes it the same way as the [`defaultMarkdownHandler`](https://gohugo.io/getting-started/configuration-markup#configure-markup) does for markdown headers.
|
|
categories: [functions]
|
|
menu:
|
|
docs:
|
|
parent: functions
|
|
keywords: [markdown,strings]
|
|
signature: ["anchorize INPUT"]
|
|
relatedfuncs: [humanize]
|
|
---
|
|
|
|
If [Goldmark](https://gohugo.io/getting-started/configuration-markup#goldmark) is set as `defaultMarkdownHandler`, the sanitizing logic adheres to the setting [`markup.goldmark.parser.autoHeadingIDType`](https://gohugo.io/getting-started/configuration-markup#goldmark).
|
|
|
|
Since the `defaultMarkdownHandler` and this template function use the same sanitizing logic, you can use the latter to determine the ID of a header for linking with anchor tags.
|
|
|
|
```go-html-template
|
|
{{ anchorize "This is a header" }} --> "this-is-a-header"
|
|
{{ anchorize "This is also a header" }} --> "this-is-also----a-header"
|
|
{{ anchorize "main.go" }} --> "maingo"
|
|
{{ anchorize "Article 123" }} --> "article-123"
|
|
{{ anchorize "<- Let's try this, shall we?" }} --> "--lets-try-this-shall-we"
|
|
{{ anchorize "Hello, 世界" }} --> "hello-世界"
|
|
```
|