Documentation · ViewHelper reference

XSD schema file | vhs master

Format / MarkdownViewHelper

Markdown Transformation ViewHelper

Requires an installed "markdown" utility, the specific implementation is less important since Markdown has no configuration options. However, the utility or shell scipt must:

  • accept input from STDIN
  • output to STDOUT
  • place errors in STDERR
  • be executable according to open_basedir and others
  • exist within (one or more of) TYPO3's configured executable paths

In other words, *NIX standard behavior must be used.

See: http://daringfireball.net/projects/markdown/ /

  • Tag usage example

    <v:format.markdown text="NULL" trim="1" htmlentities="1">
    	<!-- tag content - may be ignored! -->
    </v:format.markdown>
  • Inline usage example

    {v:format.markdown(text: 'NULL', trim: 1, htmlentities: 1)}

Arguments

Argument Description Type
htmlentities

If true, escapes converted HTML

boolean
text

Markdown to convert to HTML

string
trim

Trim content before converting

boolean
Required attribute

Revision history

commit 39671719b37f10ee4790070aa213c308ab466c9c
Author: Claus Due <*****@wildside.dk>
Date:   Sat Nov 3 22:15:03 2012 +0100

    [FEATURE] Formatting ViewHelpers
    
    Eliminate, Hide, Markdown and Ucfirst ViewHelpers.

commit a7f164b20b58f7dc7bacc1b5d0b43d6f4b4e0134
Author: Claus Due <*****@wildside.dk>
Date:   Mon Nov 5 01:07:29 2012 +0100

    [BUGFIX] Adjusted namespace of Markdown ViewHelper

commit bcb6da37b01dd15308ee339e729389ca009127a5
Author: Claus Due <*****@wildside.dk>
Date:   Fri Dec 28 01:56:02 2012 +0100

    [FEATURE] Add "htmlentities" attribute on Format / Markdown ViewHelper

commit c8955bf38213898547307fbc31372bcb6a833405
Author: Claus Due <*****@wildside.dk>
Date:   Fri Dec 28 18:45:25 2012 +0100

    [TASK] Remove old leftovers from Format / Markdown ViewHelper

commit faf2b43245369a798fda373b9a6d23e8df327cac
Author: Claus Due <*****@wildside.dk>
Date:   Sat Jan 12 22:34:09 2013 +0100

    [TASK] Remove argument "markdownExecutablePath" from MarkdownViewHelper
    
    Constitutes a security risk if attacker gains access to templates. It should be noted that if an attacker can gain such access he can do far greater damage than just that - but anyway, this closes a potential hole.

commit af09bfc8c30c7061b4273ff878fa590bd657fe5c
Author: Claus Due <*****@wildside.dk>
Date:   Sat Jan 12 22:35:19 2013 +0100

    [TASK] Adjust Exception message in Markdown ViewHelper

commit aa32ca2050a4ac2d8ff0a2183b316c7c0f2477ed
Author: Björn Fromme <*****@bjo3rn.com>
Date:   Sun May 26 16:00:15 2013 +0200

    [TASK] A*****@throws annotations

commit db3cd7ddbffc430b6a108159cfc70dbe141e5410
Author: Claus Due <*****@namelesscoder.net>
Date:   Fri Sep 13 03:08:34 2013 +0200

    [TASK] Improve test suite

commit 2ae5e0488517d84b8b71d8f94ffa1c8770c34fdc
Author: Björn Fromme <*****@bjo3rn.com>
Date:   Sat Nov 23 21:34:43 2013 +0100

    [TASK] Use TYPO3 Utility to get executable path

commit da31bad1d9bb058c072ddb5591e8ed907a1ae8e1
Author: Claus Due <*****@namelesscoder.net>
Date:   Tue Dec 31 23:08:37 2013 +0100

    [TASK] Happy new year!

commit d2e531da034976e6db1478eef5a8478595fd16fe
Author: Claus Due <*****@namelesscoder.net>
Date:   Sun Jan 5 00:45:10 2014 +0100

    [TASK] Migrate to using namespace core class names

commit 5ac1da0b5ef49e028eaa172bde671de0807a3fbf
Author: Claus Due <*****@namelesscoder.net>
Date:   Tue Apr 1 19:15:17 2014 +0200

    [DOC] Better describe conditions for using Markdown

commit e9ce10ca7a05290ad1a4832f3a8f895e0e4257ff
Author: Claus Due <*****@namelesscoder.net>
Date:   Tue Apr 15 01:28:19 2014 +0200

    [FEATURE] Implement a proper caching framework cache

commit 40d39e649f47d7f8bda58356542050b6cc59ee11
Author: Claus Due <*****@namelesscoder.net>
Date:   Tue Apr 15 11:43:40 2014 +0200

    [TASK] CGL fixes for caching framework implementation

commit da7677bc74f14e9a9300e4ba4487e52c3cb97642
Author: Claus Due <*****@namelesscoder.net>
Date:   Sun Apr 20 01:13:33 2014 +0200

    [TASK] Switch to namespaces

commit 4981055359c895f3869e5bd878293b3c15ed26e5
Author: Xaver Maierhofer <*****@xwissen.info>
Date:   Sun Jan 18 14:01:04 2015 +0100

    [TASK] CGL - Define classes, params, use imports

commit 8bb2fc5ee124ba19b0a0ab8e061c9a153fc4651f
Author: Xaver Maierhofer <*****@xwissen.info>
Date:   Sun Jan 18 17:56:13 2015 +0100

    [TASK] Reference Copyright to license.md file