Web
Article

Hemingway Editor 2 Review

By Bruno Skvorc

In 2014, Jacco Blankenspoor took a look at Hemingway Editor's new desktop app. At the time, Jacco decided he'd rather stick with the online version of Hemingway—not least because of a display bug in the desktop version. Now, a year later, our resident PHP editor Bruno Skvorc takes a look at Hemingway Editor 2 to see how it stacks up—particularly from a technical writer’s point of view.


As SitePoint’s editor for the PHP channel, I deal with a lot of text. Hundreds of emails and dozens of drafts fly before my eyes every week. This may not be obvious, but a lot goes into making the drafts publishable. There’s formatting, language corrections, image processing, code testing, syntax highlights, and more.

Hemingway App Logo

So it’s important to be able to automate as much of the low-mental-effort work as possible. Automation allows editors to focus more on content and code. This, in turn, prevents the wasting of time. It is where tools like Hemingway can help most.

What is Hemingway?

Hemingway is a writing assistance tool. It keeps an eye on one’s phrasing and sentence structure, and suggests fixes. Typical fixes include shorter sentences, active instead of passive voice, and fewer adverbs. The app is also coupled with a built-in spellchecker for several English dialects.

Hemingway App Language Selector

I’ve taken a thorough look at Hemingway Editor 2, and what follows is a list of pros and cons. The list may or may not apply to you; it depends on how much writing or editing you do and in which format. As a programmer, I’m also interested in how Hemingway handles things like code and Markdown (MD) syntax. My hope is that the list will serve as a useful guideline when considering the tool for daily use.

Pros

Language analysis, and suggestions for fixes, stand at the core of Hemingway, and are its most useful feature by far.

Hemingway highlights the sentences it dislikes and makes you stop and think before continuing. The complicated, long sentences will glow red, drawing your attention first. Those only slightly too long are highlighted in yellow.

A very red paragraph in Hemingway

In version 2, I haven’t come across the display bug that seemed to plague the desktop app when it was first launched.

Sometimes it feels like it assumes the reader is too dumb:

A yellow sentence in Hemingway

Is this really too long a sentence? In most cases, it does slow the writer down in a good way:

Hemingway suggesting the replacing of the word "assistance" with "help"

This forces a writer to think about linguistic constructs and rephrasing for wider appeal. In all honesty, though, I do consider SitePoint’s audience to be above grade level reading. A “preferred grade” setting would be useful for more scientific/technical texts.

I’m not sure I would agree with the fierce negativity towards adverbs:

Hemingway hates adverbs

… but I definitely agree with avoiding the passive voice, so having that detected is fantastic:

Hemingway detects passive tone in a sentence

Here’s an example of a paragraph that needed rewriting:

Example of a very red paragraph

Wow, that paragraph lit up like a Christmas tree, huh? Let’s try to fix it. The first red sentence uses the passive voice and is too complex.

Sentence 1 in very red paragraph has been fixed

That’s better. What about the second monstrosity, though?

Failed fixing of the second sentence

Hmm, this didn’t work. I wonder why. It’d be great if Hemingway told me exactly what it’s bothered by. It did make me think about whether the last part is even necessary, though, so I removed it.

Fixed second sentence in very red paragraph. Paragraph no longer red.

Fixing the paragraph reduced the text’s grade from 8 to 7. Success!

Unfortunately, that’s about it for the good parts.

Cons

Right off the bat, no support for Markdown is a slap in the face. Version 1 used to have it, but for some reason, it was removed.

Hemingway’s editor field is powered by CKEditor, and uses CK’s rich text functionality. This means we get inline formatting that can theoretically get exported into MD and/or HTML. However, we’re at the mercy of the exporter which, in this case, is entirely inflexible.

There’s no support for images. For me, that’s a must have in any writing environment today. If it supported MD, this would be enabled by default. Opting for a custom “rich” format grounded the editor before it had a chance to take off.

There’s also no way to define custom export methods, despite the Hemingway website’s claims to being CMS-friendly:

Hemingway's description touting CMS friendliness

It’s a pity there’s no support for code snippets, either.

The editor does support export to MD, but without images and code, so there’s little point to it for my workflow. A lot of other information gets lost in the export process, too. For example, MD doesn’t support the target attribute in links (i.e. "_blank"). Hemingway does. Thus, it gives its (non technical) users the impression that links will open in new tabs when exported to MD. Naturally, this is not so and can lead to confusion.

The editor features a Save As option, and although it does let users save a file with any extension they desire, it will not open these files. So saving a file as MD, or even trying to open one that is MD, simply isn’t available. Further, saving a file with Save As will actually not acknowledge the save, and will warn the user about unsaved changes.

Aside from the lack of Markdown support, there are also minor UI/UX gripes. First, the word counter is only visible in Edit mode, not in Write mode. A counter is very, very useful when writing articles that have a length range. Having to switch is distracting and breaks the writing flow.

Word counter and other tools in Hemingway

Second, the full screen mode could be fuller. There’s a lot of wasted real estate which could be better used to improve readability on wider screens:

Wide screen emptiness when using Hemingway in full screen mode

Also due to CKEditor, the browser’s spellchecker isn’t triggered immediately after a misspelling. This is especially true on larger bodies of text. Not a big problem, but it can be distracting.

There’s also the inconsistency of the UI. To get HTML output, you go to Save As, while getting MD or Docx requires going to File -> Export. And speaking of exports, an on-screen view of the export would be much better than a file-based export. More often than not, you just want it in your clipboard.

Some of the UI grouping is odd, too. For example, the outdent and indent buttons are on the same level as all other formatting controls. Still, they only work on list elements, and only for a single level in either direction. Pasting is also iffy: it’ll make the screen jump to an odd location in the text.

And then there are bugs. The two deal breakers I found were:

  • exporting a file into a folder where a file of the same name already exists and confirming the overwrite will silently fail
  • HTML entities get encoded when being exported, so your MD ends up looking like this:
    Broken Markdown on export from Hemingway This is unacceptable; it’s as if the app wasn’t tested at all.

Other thoughts

The Hemingway application is written purely in JavaScript, and as such exposes its code as seen here. Its offline version is a stripped down Chrome, and uses the same thing. As such, it’s very easy to just reverse-engineer it and build something better. Here’s a thought: a markdown editor that—

  • is powered by Woofmark
  • has a customizable exporter powered by CommonMark
  • has a heading normalizer powered by TitleCapitalization
  • has a body checker powered by Hemingway’s JS
  • has an image uploader powered by something like Dropzone
  • etc.

Conclusion

Hemingway’s version 2 doesn’t offer much over version 1. The new formatting tools leave much to be desired, and the new, rather basic window chrome functionality is not too exciting. The writing process is distracting and buggy rather than helpful. Various missing features plague the tool, making it still feel like an alpha product for me. But despite all this, it can be a helpful tool.

From my point of view, as someone who likes Markdown and writes about code, I can’t recommend a purchase of the desktop version. But I’ll definitely keep an eye on it and remain optimistic about its future. It’s on the way to becoming a good text editor, and there’s no surplus of those.

I give Hemingway’s current iteration a score of 2/5.

Score 2 out of 5

P.S. This text was written entirely in Hemingway and got a grade of 5. What do you think about it? Is the simplification too obvious or just right? Let me know!

  • http://architect4wp.com Chris Howard

    I actually did find the second part of this sentence wordy, and agreed with Hemingway:

    “Automation allows editors to focus more on content and code, preventing the wasting of time.”

    Do we really call it “the wasting of time”? or do we say “time wasting”?

    Hemingway was quite happy once I changed it to “preventing time wasting.”

    • http://www.bitfalls.com/ Bruno Skvorc

      Quite right :)

    • Ralph Mason

      Useful to an extent. But I hate to think what Hemingway would make of Shakespeare’s text. It’s nice for writing to have a bit of character and quirkiness now and then. :-)

      • adaivanoff

        Or maybe even the works of Mr. Hemingway himself won’t make the cut. :)

        • Chris Ward

          I was wondering that, is running Hemingway through Hemingway like Googling Google?

      • http://uk.linkedin.com/in/karlbrownactor Karl Brown

        I just ran the opening soliloquy to Richard III through it, and it recommends changing the following lines:
        “Why I, in this weak piping time of peace, have no delight to pass away the time…” to “Why I, in this weak piping time of peace, have no delight to die the time…”
        and
        “…about a prophecy which says that G of Edward’s heirs the murderer shall be.” to “…about a prophecy which says that G of Edward’s heirs the murderer must be”

        I am intrigued by the thought of die-ing time.

        • Ralph Mason

          Yes, there’s only so much computers can do for us. Ultimately we have to make the decision.

          Experiments have shown that a computer can come up with a Shakespeare sonnet, but it takes a bigger number of tries than I can possibly type here. :)

  • adaivanoff

    I never trust such tools. Yes, they could give some guidelines, but very often their recommendations are ridiculous.

    P.S. This text was written entirely in Hemingway and got a grade of
    5. What do you think about it? Is the simplification too obvious or just
    right? Let me know!

    Oversimplified. However, for a site with an international crowd (i.e. a lot of readers who are not necessarily fluent in English), probably it’s better this way because they don’t have to look up every other word.

  • Chris Ward

    After forking out the money for Hemingway (albeit only $5) I can’t use it anymore, and agreed this new version has got worse.

    I have replaced most of what it did for me with Atom + Linters + The Write Good linter which means all of my tools are in the same place to.

  • Ritesh Kumar

    I bought it and really regret that decision.

Recommended

Learn Coding Online
Learn Web Development

Start learning web development and design for free with SitePoint Premium!

Instant Website Review

Use Woorank to analyze and optimize your website to improve your website to improve your ranking!

Run a review to see how your site can improve across 70+ metrics!

Get the latest in Front-end, once a week, for free.