Блок Markdown

Введение

Блок Markdown можно использовать без привязки к источнику данных. Он использует синтаксис Markdown для определения текста и позволяет отображать отформатированный контент.

Добавить блок

Вы можете добавить блок Markdown на страницу или во всплывающее окно.

20251026230916

Также можно добавить встроенный блок Markdown внутри блоков формы и деталей.

20251026231002

Движок шаблонов

Он использует шаблонизатор Liquid, чтобы предоставлять мощные и гибкие возможности рендеринга шаблонов. С его помощью контент можно динамически генерировать и отображать в настроенном виде. Движок шаблонов позволяет:

  • Динамическая интерполяция: используйте плейсхолдеры в шаблоне для обращения к переменным. Например, {{ ctx.user.userName }} автоматически заменяется на соответствующее имя пользователя.
  • Условный рендеринг: поддерживаются условные операторы ({% if %}...{% else %}) — они отображают разный контент в зависимости от состояния данных.
  • Циклы: используйте {% for item in list %}...{% endfor %} для обхода массивов или коллекций и генерации списков, таблиц или повторяющихся модулей.
  • Встроенные фильтры: доступен набор фильтров (например, upcase, downcase, date, truncate и т.д.) для форматирования и обработки данных.
  • Расширяемость: поддержка пользовательских переменных и функций делает логику шаблонов переиспользуемой и удобной в сопровождении.
  • Безопасность и изоляция: рендеринг выполняется в изолированной среде (песочнице), что предотвращает прямое выполнение опасного кода и повышает безопасность.

Благодаря шаблонизатору Liquid разработчики и авторы контента могут быстро добиваться динамического отображения, персонализированной генерации документов и рендеринга шаблонов для сложных структур данных, существенно повышая эффективность и гибкость.

Использование переменных

Блок Markdown на странице поддерживает системные переменные (например, текущего пользователя, текущую роль и т.п.).

20251029203252

Блок Markdown в строке блока действий во всплывающем окне (или на подстранице) поддерживает больше переменных контекста данных (например, текущую запись, текущую запись всплывающего окна и т.п.).

20251029203400

Локализация

Встроенный фильтр t поддерживает локализацию текста.

Примечание: текст нужно заранее добавить в таблицу локализации. В дальнейшем будет оптимизирована поддержка пользовательской генерации терминов локализации.

20251026223542

QR-код

QR-коды можно настроить в блоке Markdown.

20251026230019

<qr-code value="https://www.nocobase.com/" type="svg"></qr-code>