microformats2-parser: A Microformats 2 parser.

[ library, program, public-domain, web ] [ Propose Tags ]

A parser for Microformats 2 (http:/microformats.orgwiki/microformats2), a simple way to describe structured information in HTML.

[Skip to Readme]


  • Data
    • Microformats2
      • Data.Microformats2.Jf2
      • Data.Microformats2.Parser
        • Data.Microformats2.Parser.Date
        • Data.Microformats2.Parser.HtmlUtil
        • Data.Microformats2.Parser.Property
        • Data.Microformats2.Parser.Util


Maintainer's Corner

For package maintainers and hackage trustees


  • No Candidates
Versions [RSS] 0.1.0, 0.1.1, 1.0.0, 1.0.1,,,,,,,,,,
Dependencies aeson, aeson-pretty, aeson-qq, attoparsec, aws-lambda-haskell-runtime, aws-lambda-haskell-runtime-wai, base (>= && <5), base-compat (>=0.8.0), blaze-html, blaze-markup, bytestring, case-insensitive, containers, data-default, either, errors, githash, html-conduit, lens, lens-aeson, microformats2-parser, network, network-uri, options, pcre-heavy, safe, scotty, tagsoup, text, time, transformers, unordered-containers, vector, wai, wai-cli, wai-extra, xml-lens, xss-sanitize [details]
License LicenseRef-PublicDomain
Copyright 2015-2021 Greg V <greg@unrelenting.technology>
Author Greg V
Maintainer greg@unrelenting.technology
Category Web
Home page https://github.com/unrelentingtech/microformats2-parser
Source repo head: git clone git://github.com/unrelentingtech/microformats2-parser.git
Uploaded by myfreeweb at 2021-06-24T15:54:35Z
Distributions NixOS:
Executables microformats2-parser-lambda, microformats2-parser
Downloads 8208 total (20 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2021-06-24 [all 2 reports]

Readme for microformats2-parser-

[back to package description]

Hackage unlicense


Microformats 2 parser for Haskell! #IndieWeb

Originally created for sweetroll.

  • parses items, rels, rel-urls
  • resolves relative URLs (with support for the <base> tag), including inside of html for e-* properties
  • parses the value-class-pattern, including date and time normalization
  • handles malformed HTML (the actual HTML parser is tagstream-conduit)
  • also can convert to JF2
  • high performance
  • extensively tested

Also check out http-link-header because you often need to read links from the Link header!



Look at the API docs on Hackage for more info, here's a quick overview:

{-# LANGUAGE OverloadedStrings #-}

import Data.Microformats2.Parser
import Data.Default
import Network.URI

parseMf2 def $ documentRoot $ parseLBS "<body><p class=h-entry><h1 class=p-name>Yay!</h1></p></body>"

parseMf2 (def { baseUri = parseURI "https://where.i.got/that/page/from/" }) $ documentRoot $ parseLBS "<body><base href=\"base/\"><link rel=micropub href='micropub'><p class=h-entry><h1 class=p-name>Yay!</h1></p></body>"

The def is the default configuration.

The configuration includes:

  • htmlMode, an HTML parsing mode (Unsafe | Escape | Sanitize)
  • baseUri, the Maybe URI that represents the address you retrieved the HTML from, used for resolving relative addresses -- you should set it

parseMf2 will return an Aeson Value structured like canonical microformats2 JSON. lens-aeson is a good way to navigate it.


Use stack to build.
Use ghci to run tests quickly with :test (see the .ghci file).

$ stack build

$ stack test

$ stack ghci


Please feel free to submit pull requests!

By participating in this project you agree to follow the Contributor Code of Conduct and to release your contributions under the Unlicense.

The list of contributors is available on GitHub.


This is free and unencumbered software released into the public domain.
For more information, please refer to the UNLICENSE file or unlicense.org.