README

Adds a Markdown content element and a Fluid ViewHelper to TYPO3 v13 and v14. Supports inline Markdown and .md files from Fileadmin, rendered via league/commonmark with optional Prism.js syntax highlighting.

Features

• TYPO3 v13+ compatible (Site Set ready)
• Inline or file-based Markdown rendering (.md, .markdown, .txt)
• Optional syntax highlighting via Prism.js (CDN toggle)
• Frontmatter metadata support (title, author, …)
• Accessible output using semantic <section> and <figure> elements
• Reusable MarkdownViewHelper for custom Fluid templates
• Configurable via Site Set settings and TypoScript

Requirements

Installation

composer require oliverthiele/ot-markdown

After installation, activate the Site Set "OtMarkdown" for your site in the TYPO3 backend.

Configuration

Site Set Settings

TypoScript

The TypoScript is auto-included via the Site Set. For manual integration without Site Set:

@import 'EXT:ot_markdown/Configuration/TypoScript/constants.typoscript'
@import 'EXT:ot_markdown/Configuration/TypoScript/setup.typoscript'

Default content element configuration:

tt_content.ot_markdown =< lib.contentElement
tt_content.ot_markdown {
    templateName = Markdown
    dataProcessing {
        10 = TYPO3\CMS\Frontend\DataProcessing\FilesProcessor
        10.references.fieldName = assets
        10.as = markdownFiles
    }
}

Usage

Content Element

Select "Markdown" as content type (CType = ot_markdown) in the TYPO3 backend. Choose between:

• Inline — enter Markdown directly in the text field
• File — select a .md, .markdown, or .txt file from Fileadmin

ViewHelper

{namespace ot=OliverThiele\OtMarkdown\ViewHelpers}

<ot:markdown text="{data.bodytext}"/>

<ot:markdown file="{file}" as="output">
    <f:format.raw>{output.html}</f:format.raw>
</ot:markdown>

Access frontmatter metadata via {output.frontmatter.title}, {output.frontmatter.author}, etc.

PHP API

use OliverThiele\OtMarkdown\Service\MarkdownService;
use TYPO3\CMS\Core\Utility\GeneralUtility;

$service = GeneralUtility::makeInstance(MarkdownService::class);
$html = $service->render('# Hello World');

License

GPL-2.0-or-later — © 2025 Oliver Thiele