Markdown Editors for the Raspberry Pi

While I can write markdown in any editor, the benefit of most markdown editors is that they do syntax checking and can show a preview of how the content will appear.

Typora instantly displays formatting as you type but you can toggle to source code mode that displays the markdown markup. Typora has become my favorite writing tool because it's clean, simple, and fast. Now that the Raspberry Pi 4 is a more capable desktop, I hope the developers of Typora will release an ARM64 version.

Meanwhile I have searched for alternatives that will run on the Raspberry Pi 4 and unfortunately there are not many options.

What I have settled on is Visual Studio Code , which is an Electron-based open source IDE developed by Microsoft. VS Code has built in support for markdown that you activate by creating a file with an .md extension. I found a VS Code extension that will display a preview of the markdown source, the result is you can have one pane display the source and another pane displaying a preview of the format and the preview is updated as you type.

Microsoft provides VS Code for free and the Linux ARM64 version is available for download from their site .

Previously, Microsoft did not release a build of VS Code for ARM64 that is needed to run on the Raspberry Pi, but Jay Rodgers is building and maintaining an ARM version called Code OSS and I found instructions for installing it on the Raspberry Pi. page . Now that Microsoft is providing ARM64 releases of VS Code I do not know how long this community version will be maintained.

Right now all the builds of Code OSS are for Raspbian Stretch and the most current release of it does not run on Raspbian Buster, which is what I am running on the Pi 4. Fortunately, there is an older version that does run and the instructions I linked to above provides the installation for that version. The instructions include a step to prevent Code OSS from being updated so that the old version doesn't get overwritten the next time you do an apt upgrade.

>**Update:** As of 1/13/2020 this issue I describe above has been fixed by the maintainer and I have removed the upgrade hold and upgraded to the current version.

An advantage of installing VS Code is that it can be used for writing for a wide variety of programming languages and there is a large library of extensions. Again, given that the Raspberry Pi 4 is much more usable as a desktop computer, I would not be surprised to see Microsoft directly releasing an ARM build.

If have discovered a feature of VS Code that has me considering switching to it as my main markdown writing tool. VS Code integrates with source code versioning tools like Git and Github and that simplifies commits and pushes to repositories.

I am storing drafts of my essays in a private repository in Github and I cloned that repository to a folder on the Raspberry Pi, which created a new folder called ~/Projects/EssayDrafts with a current copy of my draft essays.

I start VS Code and click File, Add Folder To Workspace and select the essays folder above. VS Code found the .git file that contains the repository metadata and so when I click the Source Control tool after saving a change, the change is recognized to be committed by clicking the check icon. To push the committed changes to the repository click the "..." icon and then click Push, after which I am prompted for my Github ID and password.