debian-mirror-gitlab/doc/administration/invalidate_markdown_cache.md

24 lines
1 KiB
Markdown
Raw Normal View History

2020-10-24 23:57:45 +05:30
---
stage: Create
group: Source Code
2021-02-22 17:27:13 +05:30
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-10-24 23:57:45 +05:30
type: reference
---
2021-03-11 19:13:27 +05:30
# Invalidate Markdown Cache **(FREE)**
2019-03-02 22:35:43 +05:30
2020-01-01 13:55:28 +05:30
For performance reasons, GitLab caches the HTML version of Markdown text
2021-03-11 19:13:27 +05:30
in fields like comments, issue descriptions, and merge request descriptions. These
cached versions can become outdated, such as
when the `external_url` configuration option is changed. Links
in the cached text would still refer to the old URL.
2019-03-02 22:35:43 +05:30
To avoid this problem, the administrator can invalidate the existing cache by
2020-03-13 15:44:24 +05:30
increasing the `local_markdown_version` setting in application settings. This can
2019-03-02 22:35:43 +05:30
be done by [changing the application settings through
the API](../api/settings.md#change-application-settings):
2020-03-13 15:44:24 +05:30
```shell
2021-02-22 17:27:13 +05:30
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/application/settings?local_markdown_version=<increased_number>"
2019-03-02 22:35:43 +05:30
```