Text.Pandoc

This helper module exports the main writers, readers, and data structure definitions from the Pandoc libraries.

A typical application will chain together a reader and a writer to convert strings from one format to another. For example, the following simple program will act as a filter converting markdown fragments to reStructuredText, using reference-style links instead of inline links:

module Main where
import Text.Pandoc

markdownToRST :: String -> String
markdownToRST =
  (writeRST def {writerReferenceLinks = True}) . readMarkdown def

main = getContents >>= putStrLn . markdownToRST

Note: all of the readers assume that the input text has '\n' line endings. So if you get your input text from a web form, you should remove '\r' characters using filter (/='\r').

Definitions

module Text.Pandoc.Definition

Generics

module Text.Pandoc.Generic

Options

module Text.Pandoc.Options

Lists of readers and writers

readers :: [(String, Reader)]

Association list of formats and readers.

writers :: [(String, Writer)]

Association list of formats and writers.

Readers: converting to Pandoc format

data Reader

Constructors

StringReader (ReaderOptions -> String -> IO Pandoc)

ByteStringReader (ReaderOptions -> ByteString -> IO (Pandoc, MediaBag))

mkStringReader :: (ReaderOptions -> String -> Pandoc) -> Reader

readMarkdown

Arguments

:: ReaderOptions

Reader options

-> String

String to parse (assuming '\n' line endings)

-> Pandoc

Read markdown from an input string and return a Pandoc document.

readLaTeX

Arguments

:: ReaderOptions

Reader options

-> String

String to parse (assumes '\n' line endings)

-> Pandoc

Parse LaTeX from string and return Pandoc document.

readHtml

Arguments

:: ReaderOptions

Reader options

-> String

String to parse (assumes '\n' line endings)

-> Pandoc

Convert HTML-formatted string to Pandoc document.

readNative

Arguments

:: String

String to parse (assuming '\n' line endings)

-> Pandoc

Read native formatted text and return a Pandoc document. The input may be a full pandoc document, a block list, a block, an inline list, or an inline. Thus, for example,

Str "hi"

will be treated as if it were

Pandoc nullMeta [Plain [Str "hi"]]

readJSON :: ReaderOptions -> String -> Pandoc

Writers: converting from Pandoc format

data Writer

Constructors

PureStringWriter (WriterOptions -> Pandoc -> String)

IOStringWriter (WriterOptions -> Pandoc -> IO String)

IOByteStringWriter (WriterOptions -> Pandoc -> IO ByteString)

writeNative :: WriterOptions -> Pandoc -> String

Prettyprint Pandoc document.

writeJSON :: WriterOptions -> Pandoc -> String

writeMarkdown :: WriterOptions -> Pandoc -> String

Convert Pandoc to Markdown.

writePlain :: WriterOptions -> Pandoc -> String

Convert Pandoc to plain text (like markdown, but without links, pictures, or inline formatting).

writeLaTeX :: WriterOptions -> Pandoc -> String

Convert Pandoc to LaTeX.

writeHtml :: WriterOptions -> Pandoc -> Html

Convert Pandoc document to Html structure.

writeHtmlString :: WriterOptions -> Pandoc -> String

Convert Pandoc document to Html string.

writeMan :: WriterOptions -> Pandoc -> String

Convert Pandoc to Man.

writeDocx

Arguments

:: WriterOptions

Writer options

-> Pandoc

Document to convert

-> IO ByteString

Produce an Docx file from a Pandoc document.

writeHaddock :: WriterOptions -> Pandoc -> String

Convert Pandoc to Haddock.

writeCustom :: FilePath -> WriterOptions -> Pandoc -> IO String

Convert Pandoc to custom markup.

Rendering templates and default templates

module Text.Pandoc.Templates

Version

pandocVersion :: String

Version number of pandoc library.

Miscellaneous

getReader :: String -> Either String Reader

Retrieve reader based on formatSpec (format+extensions).

getWriter :: String -> Either String Writer

Retrieve writer based on formatSpec (format+extensions).

class ToJSONFilter a => ToJsonFilter a where

Deprecated. Use toJSONFilter from Text.Pandoc.JSON instead.

Minimal complete definition

Nothing

Methods

toJsonFilter :: a -> IO ()

Deprecated: Use toJSONFilter from JSON instead