I have an org document in which I inserted fontawesome characters (with the package fontawesome).

When exporting to html, the characters are exported as is instead of being exported in html fontawesome code. For instance, should get exported as:

<i class="fa fa-plus"></i>

I guess I could achieve this with some post-export hook. How would I do ?


  • 1
    Maybe you can define your own special symbols by customizing org-entities-user.
    – Juancho
    Commented Oct 6, 2017 at 16:22

2 Answers 2


You can use @@html:...@@, for example:

@@html:<i class="fa fa-plus"></i>@@

ref: Quoting HTML tags

  • This is more portable, I like it.
    – skizo
    Commented Oct 5, 2021 at 7:44

Thanks juancho's comment, I came out with a nice setting to set this up.

You can set org-entities-user like this for example.

     (("faCogs" "\\faCogs" nil "<i class=\"fa fa-cogs\"></i>" "=cogs=" "=cogs=" "")
     ("faPlus" "\\faPlus" nil "<i class=\"fa fa-plus\"></i>" "+" "+" ""))))


The "tofus" are the symbols in fontawesome.

In my orgmode document, I just need to do \faCogs, and with M-x org-toggle-pretty-entities, the fontawesome symbol appears.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.