Pure-Haskell utilities for dealing with XML with the conduit package.


Version on this page:1.5.1
LTS Haskell 22.17:
Stackage Nightly 2024-04-14:
Latest on Hackage:

See all snapshots xml-conduit appears in

Maintained by Michael Snoyman
This version can be pinned in stack with:xml-conduit-1.5.1@sha256:87cc219e7f92c204b6e1f5788e2907e351d5f17431f75a4434d784fbe66ce9fa,2647


This package provides parsing and rendering functions for XML. It is based on the datatypes found in the xml-types package. This package is broken up into the following modules:

  • Text.XML: DOM-based parsing and rendering. This is the most commonly used module.

  • Text.XML.Cursor: A wrapper around Text.XML which allows bidirectional traversing of the DOM, similar to XPath. (Note: Text.XML.Cursor.Generic is the same concept, but will work with any node representation.)

  • Text.XML.Unresolved: A slight modification to Text.XML which does not require all entities to be resolved at parsing. The datatypes are slightly more complicated here, and therefore this module is only recommended when you need to deal directly with raw entities.

  • Text.XML.Stream.Parse: Streaming parser, including some streaming parser combinators.

  • Text.XML.Stream.Render: Streaming renderer.

Additionally, the xml-hamlet package provides a more convenient syntax for creating XML documents. For a more thorough tutorial on this library, please see http://www.yesodweb.com/book/xml.



  • New render setting, rsXMLDeclaration; setting it to False omits the XML declaration.


  • tag function no longer throws an exception when attributes don’t match #93
  • Add many_ combinator to avoid building results in memory #94
  • Turn some functions from Consumer Event m a to ConduitM Event o m a to allow yielding values
  • Replace takeAllTreesContent with takeAnyTreeContent, that only consumes one tree
  • Introduce NameMatcher type to refactor tag parsers
  • Add a couple of take* functions to stream events rather than parse them
  • Rename ignore* functions to comply with naming convention

  • Compatibility with blaze-markup- #95

  • Parse XML encoding case-insensitively
  • Remove extra EOL when printing XmlException

  • Handle CDATA in takeAllTreesContent #88


  • Improve XmlException definition and usage
  • Add ‘takeAllTreesContent’ function


  • Improvements for using xml-conduit for streaming XML protocols #85

  • transformers dep bump

  • Remove unneeded ImpredicativeTypes


  • dropWS retains consumed whitespace values #74 #75 #76

  • Generalize signature of choose (Fixes #72) #73


  • New render setting to control when to use CDATA #68
  • Escaping CDATA closing tag in CDATA #69


  • Support for iso-8859-1 #63


  • Add functions to ignore subtrees & result-streaming (yield) parsers #58


  • Drop system-filepath


  • Reuse ‘MonadThrow’ and ‘force’ for ‘AttrParser’ #52


  • Added helper functions to render XML elements #48


  • ‘parseText’ becomes ‘parseText’/‘parseTextPos’, depending on the output type #47

  • Allow blaze-builder 0.4

Support monad-control 1.0