In AnQiCMS, flexibly choose the handy editing tool when managing content, which can make your content creation twice as effective.Markdown editor is favored by many content creators due to its concise syntax and support for specific advanced features (such as mathematical formulas and flowcharts).AnQiCMS as a system dedicated to providing an efficient and customizable content management solution naturally also considers this point, allowing you to easily enable or disable the Markdown editor feature according to your actual needs.
Easily switch: Enable or disable Markdown editor feature
To enable or disable the Markdown editor in the AnQiCMS backend, the entire process is very intuitive. You only need to go through a few simple steps to complete this operation:
Firstly, please log in to the AnQiCMS backend management interface using the administrator account.After logging in, you will see a series of feature options in the navigation menu on the left.Backend settingsThis item.
In the expanded submenu of “Background Settings”, you will see “Content Settings” options. Click to enter the “Content Settings” page, where various configuration items related to content publication and display are gathered.
In the "Content Settings" page, browse through the various configurations, and you will find one named "Whether to enable Markdown editorThe option. This option is usually presented as a switch or a checkbox.
If you want to write articles using Markdown, just flip the switch to “EnabledStatus (or tick the checkbox). If you are more accustomed to traditional rich text editors (WYSIWYG editing mode), then set it to “DisabledStatus (or uncheck).
Be sure to click the "SaveButton, to ensure that your settings take effect.The content editor type will automatically switch after you save.This means that the next time you enter the "Add Document" or "Edit Document" page, you will see the corresponding editor interface.
Understand the impact of switching to the Markdown editor.
It is very helpful to understand the specific impact on content management and display after switching to the editor:
After you enable the Markdown editorIn your post or edit article, the content input box will become a text area that supports Markdown syntax.You can use the concise formatting syntax of Markdown to format text, insert images, create lists, and more.At this time, AnQiCMS will automatically identify and convert its content to a HTML format that browsers can recognize, so that it can be displayed normally on the front-end page.For users who want to use Markdown to write mathematical formulas or draw flowcharts, this is a very practical feature, which can greatly enhance the professionalism and diversity of content expression.
When you disable the Markdown editorThe system will switch back to the default rich text editor of AnQiCMS.This editor provides an interface similar to Word, where you can complete operations such as bold, italic, inserting images, etc. by clicking buttons, without needing to memorize complex Markdown syntax.
It is worth noting that AnQiCMS is very intelligent in handling content rendering. Even if you disable the Markdown editor, for thoseThe content that has already been written and saved using Markdown syntax,AnQiCMS default template tags (such asarchiveDetail/pageDetailetc., are also provided when callingContentfields)renderParameters. This means that even if the Markdown editor is disabled, you can still callContenta field by adding extrarender=trueParameters (e.g.,){% archiveDetail archiveContent with name="Content" render=true %}{{archiveContent|safe}}This forces the system to convert Markdown content to HTML and display it. This provides you with great flexibility and ensures the compatibility and sustainability of your website content.
Expansion Application: Make Markdown content more vibrant on the front end
Enable Markdown editor is just the first step.If you use advanced Markdown features such as mathematical formulas or flowcharts in the content, you may also find that they are not displayed directly as expected on the website front-end.This is because, to correctly render these special elements, it usually also requires the introduction of additional CSS styles and JavaScript libraries on the front-end page.
AnQiCMS's Markdown feature takes this into account, allowing you to freely integrate third-party frontend libraries to enhance the display effect. For example, you can refer to the relevant documents in the front-end template files (usuallybase.htmlthe file<head>part) introducing, likegithub-markdown-cssused for basic Markdown styling, as well asMathJaxandMermaidthis JavaScript library specifically used for rendering mathematical formulas and flowcharts.
Through such settings, your Markdown content can be easily edited in the background and presented to visitors in a professional and beautiful way on the front page, truly bringing out the full potential of the Markdown editor.
Common Questions (FAQ)
1. If I enable the Markdown editor, what will happen to the content published using the rich text editor before?
When you switch to the Markdown editor, the content of the articles published using the rich text editor will not be affected. They will still be displayed in HTML format.The newly published article or the old article you edit in the Markdown editor will be saved in Markdown syntax, and it will be automatically rendered as HTML on the front end by AnQiCMS.
2. I enabled the Markdown editor and wrote mathematical formulas or flowcharts in the article, but why are they not displayed normally on the front page?
Markdown editor itself is responsible for writing content using Markdown syntax in the background, while the correct display of complex elements such as mathematical formulas or flowcharts requires that your website's front-end page loads the corresponding CSS styles and JavaScript libraries. You need to follow the document instructions of AnQiCMS, in your template file (usuallybase.html）Incorporating corresponding CDN resources, for example,github-markdown-css/MathJaxandMermaidto enable these advanced features to render normally on the front end.
3. Does Safe CMS support the use of two different editors simultaneously, such as using Markdown for some articles and rich text for others?
render=trueParameter to ensure its normal display.