Skip to content

Instantly share code, notes, and snippets.

@evanwill
Last active February 9, 2023 04:31
Show Gist options
  • Star 1 You must be signed in to star a gist
  • Fork 1 You must be signed in to fork a gist
  • Save evanwill/0facd7dc62b154861a74a13c9b0d55f9 to your computer and use it in GitHub Desktop.
Save evanwill/0facd7dc62b154861a74a13c9b0d55f9 to your computer and use it in GitHub Desktop.

Writing in Markdown

Markdown is a quick and simple way to write formatted documents in plaintext. It is easy to read as plaintext, but is designed to convert to HTML for easy web publishing. Writing in plaintext rather than proprietary formats such as Word has many advantages:

  • simple - dont waste time in complex and frustrating formatting in Word that will be deleted by publishers anyway. This keeps your distractions to a minimum.
  • sharable - any device can open and read plaintext.
  • preservable - markdown is plaintext which is easy for digital preservation, unlike Word.
  • version controlable - you can use the full power of Git or other version control systems.

GitHub Markdown

Markdown was originally developed by Daring Fireball. However, other "flavors" of md have developed. The most popular is GitHub markdown flavor, since it can be used anywhere on GitHub.

Here are some tutorials:

Markdown editors

You can write markdown in any application that supports plaintext, i.e. a text editor. Many text editors have plugins or features to make it easier with previews of your document. However, there are also applications devoted specificially to writing in Markdown:

  • Typora - live preview writing focused slick new app.
  • Remarkable - code / preview split screen.
  • Dillinger - in browser, nothing to install.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment