yesod-markdown

Tools for using markdown in a yesod application

http://github.com/pbrisbin/yesod-markdown

Version on this page:	0.12.6.12
LTS Haskell 24.18:	0.12.6.14
Stackage Nightly 2025-11-01:	0.12.6.14
Latest on Hackage:	0.12.6.14

See all snapshots yesod-markdown appears in

GPL-2.0-only licensed by Alexander Dunlap, Patrick Brisbin

Maintained by Patrick Brisbin

This version can be pinned in stack with:yesod-markdown-0.12.6.12@sha256:391b68c2d9b4faaec27ac289eba8349e99f923ed60c037edeecd15c1dc2b65ec,1660

Module documentation for 0.12.6.12

Yesod
- Yesod.Markdown

Depends on 12 packages(full list with versions):

base, blaze-html, blaze-markup, bytestring, directory, pandoc, persistent, shakespeare, text, xss-sanitize, yesod-core, yesod-form

Yesod Markdown

A small wrapper over Pandoc’s powerful Markdown -> Html support, with usage tailored for Yesod.

Usage

getPageR :: FilePath -> Handler RepHtml
getPageR fp = do
    content <- liftIO
        $ fmap markdownToHtml
        $ markdownFromFile fp

    defaultLayout $ do
        [shamlet|
            <div class="content">
                #{content}
            |]

The default extensions are minimal, you can specify you’re preferred extensions with markdownToHtmlWithExtensions:

import Text.Pandoc.Extensions (githubMarkdownExtensions)

getPageR :: FilePath -> Handler RepHtml
getPageR fp = do
    content <- liftIO
        $ fmap (markdownToHtmlWithExtensions githubMarkdownExtensions)
        $ markdownFromFile fp

    defaultLayout $ do
        [shamlet|
            <div class="content">
                #{content}
            |]

For more information, see the haddocks.

Developing & Tests

stack setup
stack build --pedantic --test

CHANGELOG | LICENSE

Changes

Unreleased

None

v0.12.6.12

Relax test assertion for change in xss-sanitize behavior.

v0.12.6.11

Released without changes, to test release automation.

v0.12.6.10

Remove all dependencies upper bounds

v0.12.6.9

Allow yesod-form-1.7

v0.12.6.8

Allow persistent-2.12

v0.12.6.7

Allow pandoc-2.13

v0.12.6.6

Allow pandoc-2.12

v0.12.6.5

Fix incorrect dependency bounds

v0.12.6.4

Allow pandoc-2.11 and bytestring 0.11

v0.12.6.3

Allow pandoc-2.9

v0.12.6.2

Allow pandoc-2.7

v0.12.6.1

Allow pandoc-2.6

v0.12.6.0

Allow pandoc-2.5

v0.12.5

Allow pandoc-2.4

v0.12.4

Support GHC 8.4 (@waddlaw)

v0.12.3

Added markdownToHtmlWith & markdownToHtmlWithExtensions
Deprecate internal conversion functions

v0.12.2

Allow yesod-1.6 (@bitemyapp)

v0.12.1

Allow pandoc-2.1

v0.12.0

Require pandoc-2.0, support GHC 8.2 (@cdepillabout)
Drop GHC 7.10 support

v0.11.4

Allow blaze-html-0.9 and blaze-markup-0.8 (@cdepillabout)

v0.11.3

Allow pandoc-1.19 (@gfontenot)

v0.11.2

No changes

v0.11.1

Allow pandoc-1.17 (@andrewthad)

v0.11.0

Allow pandoc-1.16

v0.10.0

Require pandoc-1.14, support pandoc 1.15 (@robgssp)

v0.9.4

Allow blaze-html-0.8 (@geraldus)

v0.9.3.1

Correct license field (@nkaretnikov)

v0.9.3

Allow yesod-1.4 (@nek0)

v0.9.2

Allow pandoc-1.13 (cosmo0920)

v0.9.1

Remove temporary < 1.2.0.2 workaround
Add dependency bounds to avoid broken texmath-0.6.5.1

v0.9.0

Support shakespeare (renamed from hamlet package)

v0.8.5

Add upper bound on temporary-1.2.0.2
Write PersistFieldSql instance by hand

v0.8.4

Allow text-1.*
Allow blaze-html-0.7 and blaze-markup-0.7

v0.8.3

Allow up to text-1.1 (@trofi)
Set writerHighlight (@cosmo0920))

v0.8.2

Allow pandoc-1.12 (@cjwatson)

v0.8.1

Derive PersistFieldSql

v0.8.0

Support yesod-1.2 (@gregwebs)

v0.7.2

Support yesod-1.1 (@gregwebs)

v0.7.1

Trim \r from textarea content

v0.7

Fix reading content with UTF-8 characters

v0.6

Support pandoce-1.10

v0.5.1

Allow newer persistent (@gregwebs)

v0.5.0

Require yesod-1.1 and yesod-form-1.2 (@dlthomas)

v0.4.1

Require blaze-html 0.5 (@lbolla)
Allow yesod-1.1 (@SimSaladin)

v0.4.0

Support yesod-1.0 (@pSub)

v0.3.4

Drop GHC 6 support (@pSub)

v0.3.3

Break up yesod dependency (@gregwebs)

v0.3.2

Require pandoc-1.9

v0.3.1

This is the first version where we begin tracking changes.