2020-07-30 12:09:33 +00:00
---
2021-02-19 12:11:06 +00:00
stage: Plan
group: Project Management
2022-09-22 00:11:23 +00:00
info: "To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments"
2020-07-30 12:09:33 +00:00
type: reference
---
2022-06-21 09:08:20 +00:00
# Markdown cache **(FREE)**
2019-01-31 11:28:31 +00:00
2022-06-21 09:08:20 +00: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-28 00:09:33 +00:00
in the cached text would still refer to the old URL.
2019-01-31 11:28:31 +00:00
2022-06-21 09:08:20 +00: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 11:28:31 +00:00
2020-01-30 15:09:15 +00:00
```shell
2020-12-09 06:09:41 +00: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 11:28:31 +00:00
```