Merge 7ec3abcd74c0908b05e8b7365f92eac39c4e522a into ea0b975d6a3791327fa95bba8a0dfbb07c8e9f01

This commit is contained in:
Jeff Dairiki 2025-03-10 10:37:25 +00:00 committed by GitHub
commit d1035b6185
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -8,7 +8,7 @@ type: filter
---
version_added: 2.0
---
body:
body:
This filter converts a markdown string into HTML. This behaves the same as
the [Markdown Type :ref](../../../db/types/markdown/).
@ -20,3 +20,13 @@ the [Markdown Type :ref](../../../db/types/markdown/).
{{ "Hello **World**"|markdown }}
</div>
```
## Controlling URL Resolution
By default, an attempt is made to resolve relative URLs in markdown *links* and *image* tags to a *record* through the Lektor database.
This makes things “just work” when linking to images and other attachments from pages that have a non-default [alt :ref](/docs/content/alts/),
as well as in other edge cases e.g. involving custom [slug_formats :ref](/docs/models/children/#child-slug-behavior).
This behavior can be controlled by passing an optional `resolve_links` parameter to the filter.
This works like the [resolve_links :ref](/docs/api/db/types/markdown/#resolution-of-links) option of the *Markdown field type*.