Markdown Editing Apps

TPF’s Discourse platform uses Markdown which is a simplified markup language developed for use on the internet.

Although Markdown can be written with any text editor - which is the point! - becoming familiar with the conventions takes some time if you’re not particularly tech-oriented.

Hence the software category of Markdown editors, inexpensive or free software applications which let you enter Markdown in WYSIWYG format.

Here is an article from my tech writing site which reviews some common markdown editors and provides a bit of background.

Markdown for Tech Writing

Personally I’ve really grown to like Bear. It’s Mac and iOS only, but it’s a really cool tool for composing longer forum posts as it mirrors Discourse’s formatting conventions (with some small variations), and it syncs your files between all your devices. The others reviewed also have their strong points and most are cross-platorm.

Any questions please feel free to ask.

2 Likes

What benefit do you find in it over just using the editor on the forum? It has bold, italic,

quotes,

links, code snippets,

  • lists.

What thing are these standalone editors giving you that makes it worth it to edit your posts externally?

When composing a reply that has numerous quotes - I find it easier to handle them externally. Also things that I write which can later be transferred to the forum.

Mind you I do a lot of writing.

Is this partly in response to my question in TPF’s April Reading Group? That is, the problematic transition of quotes from a pdf version of ‘The Will to Believe’.
April Reading: “The Will to Believe” by William James - Books and Papers / Reading Groups - The Philosophy Forum

I’ve read your excellent technical piece with its ‘Feature Wrap’.
For me, Zettir seems to tick all the boxes. It’s open source, has wikilinks but it doesn’t synch between devices. And I’m not sure I can spend the time or limited brain power working it out.

Would you be able to provide an example of how this works in practice?

Basically, how would it convert Jonathan Bennett’s pdf without damaging its format?

pdfs can be opened with a pdf reader with edit capabilities and text selected and copied into any application. I use a pdf app called PDF Expert but there are many others. I nowadays avoid Adobe because it’s moved to a subscription model and is pretty expensive. MS Word also opens PDFs and converts them on the fly.

But as Jamal pointed out for the William James essay a text edition had also been provided which bypassed pdf.

Thank you. What do you mean by ‘on the fly’?

I’m asking not only because of the Reading Group discussion.

I’m reminded of previous TPF writing events with @Baden’s suggestion re using compatible formatting pre- submission.
I can’t remember the details and, now, it’s probably irrelevant!

Indeed. And I will probably use it. @Jamal’s OP is clear and comprehensive re available options. And the use of best one for quoting in TPF.

Hi - hope this might help. The forum editor is great.

However, if you want to write e.g. a story and use Word, then my understanding is that it will not copy the format over.

This means the line breaks are uneven and the various emphases are lost.

The transition was an issue, for some, in the previous TPF Writing Events.

Can’t remember how it was resolved but probably irrelevant now. Perhaps @Baden would know…

Sorry if this is confusing. It reflects how I feel. :confused:

1 Like

That’s an old-school computer term. meaning something you can do as part of a single action, rather than having to undertake another step first. Like, opening a PDF in word, you just open it, you don’t have to perform a ‘convert’ step.

To add to what @Wayfarer said, when writing a long post it makes sense to compose it offline and save it to your computer, before you think about sending it off into the cloud. At least, this seems the best way to me.

There’s also the fact that if you do a lot of writing, you’ll have your own favourite writing setup, in a writing app or your favourite text editor. This is the most convenient, most comfortable place to be, an oasis of creative calm, where there are no distractions, notifications, etc.

EDIT: And since both the writing apps and Discourse use Markdown, you can just copy and paste between them and everything just works.

1 Like

Posters had to use paste bin if they wanted tags included. So then we would follow their paste bin link and copy from there into an OP and their tags would work. In fact, I needed to do that for the philosophy writing activity too. And it was awkward as it was a long essay.

I wonder what it’s like here if you paste from Word into a post. In other cases it preserves formatting so maybe it does in that case too.

Major Incident Summary

Incident Summary

Incident ID 355761
Date of Incident 27 Aug 2025
Start Time 15:32
End Time 15:36
Duration 4 Minutes
Affected Systems Posts

1. Overview of the Incident

On the date listed above, The Philosophy Forum experienced a service disruption affecting the systems noted. During this period, some users may have been unable to complete routine operations such as processing orders or syncing data. We identified the issue, implemented a resolution, and have since restored normal service levels.


This was copied and pasted directly from micorosft word, and kept in tact headings and tables. That’s pretty interesting.

1 Like

It works fine. In that respect Discourse is streets ahead of Plush. (On Plush I sometimes used a text editor called Sublime in which I had created macros for italic, bold, url etc - no longer needed.)

But I haven’t been using MS Word now I’m no longer in tech writing.

What would be needed ideally would be that the form received in a message could be copy-pasted directly into an OP as is. And maybe this works here because I just copied this from the above message (no tags):

Incident ID 355761
Date of Incident 27 Aug 2025
Start Time 15:32
End Time 15:36
Duration 4 Minutes
Affected Systems Posts
1 Like