As a senior security CMS website operation person, I fully understand your concern for the continuity of content display and configuration during the system upgrade.Markdown, mathematical formulas and flowcharts are an important part of modern content creation, and whether their configuration can be seamlessly connected after version updates is a concern for many operators.Next, I will elaborate on this aspect in detail based on my in-depth understanding of AnQiCMS.

AnQiCMS 更新后 Markdown、公式与流程图配置的延续性分析

In the daily operation of Anqi CMS, we deeply understand the importance of the choice of content editor and its extended features.AnQiCMS introduces a Markdown editor, and supports integration of mathematical formulas and flowcharts through third-party plugins, greatly enriching the expression of content.However, when it comes to system version updates, whether these features will be retained requires us to conduct a detailed analysis from several different levels.

The core mechanism of AnQi CMS for handling Markdown content lies in its background content editor.According to the description of the existing documents, "New version of Anqi CMS has added Markdown editorThis indicates that the conversion of Markdown text to HTML is a process controlled by the backend, which depends on the enable status of the Markdown editor on the 'Content Settings' page under the 'Global Settings' in AnQiCMS backend.

The display of mathematical formulas and flowcharts is different in mechanism, and the document explicitly states that they 'all require third-party plugin support to be displayed normally'.This means that, in addition to the backend parsing of Markdown, your website's frontend also needs to integrate specific JavaScript libraries (such as MathJax for formulas, Mermaid for flowcharts) and corresponding CSS styles to properly render these advanced content.base.html）中手动添加 CDN 链接或本地脚本。

Considering the above mechanisms, we can perform the following scenario analysis on the retention of configurations after version updates:

Firstly,About the enable status and backend parsing capabilities of the Markdown editor.The "Enable Markdown Editor" setting of AnQi CMS is stored in the system configuration and is usually retained in the database with the update of the core program.Unless the update log explicitly states that this type of user configuration will be reset, this setting is usually not changed.This means that if your content is stored in Markdown format and the Markdown editor is enabled before the update, the content will still be correctly parsed as HTML after the update.

Secondly,About the front-end rendering configuration of mathematical formulas and flowcharts.This is the key point you need to pay special attention to. Since these rendering features depend on the third-party library references you manually add in the template file, whether the configuration is retained or not directly depends on how you handle the template processing during the update process.

If you choose to update the AnQiCMS core program,retain the custom template you are currently using, without replacement or update,then all the information you have inbase.htmlThe CDN links for MathJax, Mermaid scripts, and Markdown styles added manually in other related template files will continue to exist.In this case, as long as the backend Markdown editor remains enabled and the content itself is in the correct Markdown format (including formula and flowchart syntax), the display of these advanced content on the front end will not be affected, and no reconfiguration is required.

However, if you are updating the AnQiCMS core program at the same time,Choose to update, replace, or switch to a completely new template, then the new template file may not contain the integrated code for the mathematical formulas and flowcharts that you added manually.Because the default template provided by the official or new third-party templates usually only includes basic functions, it does not pre-integrate all possible third-party libraries.help-markdown.mdDocuments instructions, manually add the relevant code for MathJax and Mermaid to the new template.base.htmlIn the file, make sure that the Markdown editor is enabled in the background "Global Settings".

Suggested and operation steps:

To ensure that the updated content is displayed correctly, regardless of which update strategy you choose, I recommend that you perform the following operations after updating the AnQiCMS version:

  1. Check background settings:Login to the AnQi CMS backend, go to 'Global Settings' -> 'Content Settings', and confirm that the 'Enable Markdown Editor' option is still enabled.
  2. Backup template file：Before performing any system updates or template replacements, you must backup your current template folder. This includespublic/static/static resources in the directory:/templateAll template files under the directory, especially the ones you may have modifiedbase.htmlor other core templates.
  3. Validate front-end rendering:Update completed, immediately visit the page containing mathematical formulas and flowcharts and check if its display is normal on the front end.
  4. Reintegrate (if necessary):If the formula or flowchart does not render correctly, comparehelp-markdown.mdthe document, check yourbase.htmlor the currently used base template file, make sure that the CDN references for MathJax and Mermaid have been added correctly.

In summary, the parsing capability of the Markdown content by Anqi CMS on the backend will remain stable after the version update, but the front-end rendering of mathematical formulas and flowcharts is highly dependent on the manual integration in the template files.Manage your template files properly during the update process, and perform necessary checks and reconfiguration after the update to ensure a smooth transition of content.

Common Questions (FAQ)

1. I upgraded AnQiCMS, but the original mathematical formulas and flow charts on the website cannot be displayed. What is the reason?This is usually because you have updated or replaced the template files during the upgrade process, resulting in the loss of JavaScript code and CSS styles used to render mathematical formulas (such as MathJax) and flowcharts (such as Mermaid). You need to according tohelp-markdown.mdThe guidance of the document, re-add the references to these third-party libraries to the template file you are currently using (for example,base.html）中。Please check if the Markdown editor is enabled in the "Global Settings" -> "Content Settings" of the security CMS backend.

2. Even if I have enabled the Markdown editor, the Markdown syntax in the content is still not converted to HTML, what is the problem?Firstly, please make sure that your content is indeed written in Markdown syntax.If confirmed to be correct, and the Markdown editor is enabled, but the content has not been converted, it may be due to caching.Please try clearing the browser cache and the system cache of the CMS backend.tag-/anqiapi-archive/142.htmlinContentThe way to call the field, ensure that it is not explicitly set.render=falseOr check if there is any other custom logic that interferes with the default Markdown rendering.

3.If I upgrade from an older version and I haven't used the Markdown editor before, will my old content be automatically converted to Markdown in the new version?I won't.AnQiCMS Added Markdown editor, you can choose to use Markdown format when creating or editing content in the background.But the content you have previously entered, if it was originally input in plain text or rich text (HTML) format, the system will not automatically convert it to Markdown format.You need to manually edit these old content, convert them to Markdown syntax, so that you can use the Markdown editor for management and rendering.