Skip to main content
  1. All Posts/

endophile

Tools HTML

endophile


A Clojure markdown parsing tool wrapping java’s pegdown library. It is designed to convert markdown into clojure data structures, which can then be used to generate HTML through another library, such as enlive or hiccup.
Endophile fully passes the original markdown test suite.

Usage

In project.clj, :dependencies [[endophile "0.2.1"] ...]
endophile.core/md takes a markdown string, and returns an
org.pegdown.ast.RootNode, the root of the document’s parse tree.
endophile.core/to-clj converts a RootNode into a clojure data structure.
Currently it returns nodes as used in clojure.xml and in the enlive HTML library.
So for example,

(ns my-namespace
  (:use [endophile.core :only [mp to-clj html-string]]
        [endophile.hiccup :only [to-hiccup]]
        [hiccup.core :only [html]]))

;; parsed is an org.pegdown.RootNode
(def parsed (mp (slurp "README.md")))

;; convert to html using clojure.xml and enlive
(println (html-string (to-clj parsed)))

;; convert to html using hiccup
(println (html (to-hiccup parsed)))

Will convert README.md to html. Also you can run it from the command line,
like so,
lein run -m endophile.core README.md > README.html
There is also an implementation that returns hiccup-style vectors. See hiccup.clj.

TODO

Currently does not support the full complement of extensions available through pegdown. Pull requests are encouraged.

FAQ

asm-all dependency

If you use some other libraries that use old versions of org.ow2.asm/asm-all (like Figwheel) it is possible you’ll encounter error like:

IllegalArgumentException   org.objectweb.asm.MethodVisitor.<init> (:-1)

You can check if you have old asm version by checking lein deps :tree or boot show -d. To fix this problem you can add asm-all dependency to your project. Local dependency will override transitive dependencies. Another solution would be to add :exclusions to the other dependency.

License

Copyright © 2013 Jonathan Brown
Distributed under the Eclipse Public License, the same as Clojure.