2020-07-30 08:09:33 -04:00
---
2021-02-19 07:11:06 -05:00
stage: Plan
group: Project Management
2020-11-26 01:09:20 -05:00
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments"
2020-07-30 08:09:33 -04:00
type: reference
---
2022-06-21 05:08:20 -04:00
# Markdown cache **(FREE)**
2019-01-31 06:28:31 -05:00
2022-06-21 05:08:20 -04:00
For performance reasons, GitLab caches the HTML version of Markdown text in fields such as:
- Comments.
- Issue descriptions.
- Merge request descriptions.
These cached versions can become outdated, such as when the `external_url` configuration option is changed. Links
2021-01-27 19:09:33 -05:00
in the cached text would still refer to the old URL.
2019-01-31 06:28:31 -05:00
2022-06-21 05:08:20 -04:00
## Invalidate the cache
Pre-requisite:
- You must be an administrator.
To avoid problems caused by cached HTML versions, invalidate the existing cache by increasing the `local_markdown_version`
setting in application settings [using the API ](../api/settings.md#change-application-settings ):
2019-01-31 06:28:31 -05:00
2020-01-30 10:09:15 -05:00
```shell
2020-12-09 01:09:41 -05:00
curl --request PUT --header "PRIVATE-TOKEN: < your_access_token > " "https://gitlab.example.com/api/v4/application/settings?local_markdown_version=< increased_number > "
2019-01-31 06:28:31 -05:00
```
