Skip to content
HomeVideosBooksBlogs
AllTop postsTopics
Podcasts
HistoryListsWatch laterLiked videosFollowing

The videos, books, blogs and podcasts Hacker News keeps recommending, all in one place.

VideosBooksBlogsPodcastsAboutPrivacySettings

Data from Hacker News, HackerTube, HackerBooks, HackerBlogs and Open Library. Credits · Not affiliated with Y Combinator.

HomeVideosBooksBlogsPodcasts
Ctrl K

    John MacFarlane

    johnmacfarlane.net · Personal blog · on HN since 2009

    John MacFarlane, a philosophy professor at UC Berkeley, writes about pandoc, CommonMark, and Markdown, which he created or helped design.

    Visit blogHN submissions
    Open Source & LinuxLanguages & CompilersWriting & Thinking
    What HN says

    Commenters are impressed that a philosophy professor built pandoc, which many use daily, and link his 'Beyond Markdown' post for background on Markdown's limits.

    Stats for nerds
    130HN people shared it
    13linked in comments
    129story points
    Aug 2026last shared
    2010people per year2026

    Top posts on HN

    1. 1
      Pandoc: universal document converter
      2 people · 103 points · first shared 2011 · 11 comments on HN
    2. 2
      Beyond Markdown (2018)
      9 people · 13 points · first shared 2020 · 1 comments on HN
    3. 3
      Pandoc - a universal document converter
      80 people · 8 points · first shared 2009 · 1 comments on HN
    4. 4
      Pandoc 1.13 released
      1 person · 3 points · first shared 2014 · Discussion on HN
    5. 5
      John MacFarlane: Author of pandoc, texmath, gitit, yst, CommonMark
      5 people · 2 points · first shared 2013 · Discussion on HN
    6. 6
      README
      14 people · first shared 2011
    7. 7
      Epub
      5 people · first shared 2012
    8. 8
      Pandocs markdown
      3 people · first shared 2013
    9. 9
      Installing
      2 people · first shared 2014
    10. 10
      Babelmark2
      2 people · first shared 2018

    What HN people wrote when they linked it

    • svatNov 2019

      > Try pasting in 10 * characters and you'll see that it's almost impossible.

      Works fine for me: https://i.imgur.com/QssB5YV.gif

      Note that:

      • The premise of the app is that you type or paste in Markdown syntax, and see the corresponding rendered output in the editor (except when the cursor is inside that area). As asterisks have a special meaning in Markdown, you should expect to see bold text (rather than the asterisks) when you type or paste something like asterisk-asterisk-foo-asterisk-asterisk.

      • The intended meaning of ten asterisks in a row is hard to predict from the Markdown syntax definition. Their rendering as two bold asterisks seems to be not what the majority of Markdown converters do, but according to Babelmark it is consistent with a few, including the original Markdown.pl: https://johnmacfarlane.net/babelmark2/?text=Asterisks+on+the+next+line%3A%0A**********%0AAnd+on+the+same+line%3A+********** (Of course, it is best to avoid any such edge cases where Markdown converters differ; CommonMark notwithstanding.)

    • hugofirthOct 2013

      People who don't use TeX for accessibility reasons might want to give it another look. The tooling has risen in quality and accessibility hugely of late. I use TexPad[1] - which I like enormously.

      Otherwise, as another commenter mentioned, there is always Markdown. Combined with MathJax[2] and custom style sheets you see many of the same benefits with greatly increased simplicity. A great desktop Markdown editor (if people don't like web based ones) is Mou[3].

      Lastly - the advantage to using Markdown is that if you have to work with someone who does use TeX - something like pandoc[4] can be used to convert between formats fairly nicely.

      One thing I think is missing is a "Make" like program to dictate how to combine multiple Markdown or TeX documents into a single document, which folders to scan for references etc. I've seen a couple of home grown solutions - but nothing that really fit the bill.

      [1]: https://www.texpadapp.com/

      [2]: http://www.mathjax.org/

      [3]: http://mouapp.com/

      [4]: http://johnmacfarlane.net/pandoc/

    • 1331Dec 2012

      It seems that the terminology is causing some confusion. The definition of a wiki is "a website which allows its users to add, modify, or delete its content via a web browser" [1], which is pretty much the opposite of "static." I assume that what you want is a static site generator that has organisational features that are common in wiki software...

      My favourite wiki software is Gitit [2]. It uses Pandoc [3] to convert from an input format (such as Markdown) to HTML. Perhaps you could write a simple script that iterates through all source files and renders the HTML to a destination directory using Pandoc, creating any subdirectories as required. That minimal solution should be very easy to implement; adding organisational markup within the HTML would require some programming.

      [1] http://en.wikipedia.org/wiki/Wiki

      [2] http://gitit.net/

      [3] http://johnmacfarlane.net/pandoc/

    • dfcOct 2012

      I really hope that they borrow a lot if not everything from pandoc[1]. My only real complaint with pandoc is the table formatting, but I think fiddlosopher is adding org-mode like table support.

      If you have not taken a pandoc for a spin I highly recommend you do so soon. In addition to being a great markdown dialect the pandoc tool set is the swiss army knife of text formatting. It is amazing how many formats pandoc can read and/or write.

      [1] http://johnmacfarlane.net/pandoc/README.html

      EDIT: I spoke too soon, Fiddlosopher continues to impress. I just checked the open issues and a little less than a month ago he added "limited org-table support." Based off of the rest of pandoc "limited" probably means something like 85% to 95% :)

      https://github.com/jgm/pandoc/issues/519

    • GlennSApr 2015

      There are a couple of alternatives that I find quite useful.

      For very small documents (a couple of pages at most), writing in Markdown and running it through Pandoc (http://johnmacfarlane.net/pandoc/) gives good results for very little effort.

      For most things, I use Org-Mode for Emacs (http://orgmode.org/), which is an absolute joy to use. It outputs via Latex, and if you want a bit of extra customization you can include Latex statements verbatim. Org-Mode also works as a literate programming environment if you want to include and run bits of code, include parts of other files, or if you want to generate charts or diagrams.

      Edit: I should also mention that org-mode has a great table editor.

    • reconbotSep 2014

      I think this is great, I'm all for extending markdown for specific situations but I think the base h1, li, and p tags should be clearly defined. It appears that most parsers could adopt most of the spec without breaking backwards compatibility. (I'm probably wrong.)

      There's an obvious annoyance with markdown like this, where a lack of a blank line after the headlines causes problems but only in a few parsers. I'm glad to see most of them do the right thing.

      http://johnmacfarlane.net/babelmark2/?normalize=1&text=%23+I+love+this+stuff%0A%23%23+A+LOT!%0A-+li+1%0A-+li+2!

    Related

    Mark Shuttleworthmarkshuttleworth.com134 people

    Announcing Ubuntu Core, with snappy transactional updates

    Mark Shuttleworth
    Personal · last shared 2023
    John Regehrblog.regehr.org401 people

    Teaching C

    John Regehr
    Personal · last shared 2026
    Gödel's Lost Letterrjlipton.wordpress.com185 people

    Mihai Pătraşcu 1982–2012

    Gödel's Lost Letter
    Personal · last shared 2021
    Daring Fireballdaringfireball.net1.8k people

    Facebook is an attack on the open web

    Daring Fireball
    Personal · last shared 2026
    Mark Dominusblog.plover.com326 people

    The shittiest project I ever worked on (2013)

    Mark Dominus
    Personal · last shared 2026
    Bruce Tognazzininomodes.com17 people

    The Law of Conservation of Complexity

    Bruce Tognazzini
    Personal · last shared 2024
    Jason Blevinsjblevins.org51 people

    Deft -- easy note taking for Emacs

    Jason Blevins
    Personal · last shared 2026
    John Wiegleynewartisans.com49 people

    Monads in pictures

    John Wiegley
    Personal · last shared 2026