Introduction to Markdown digital workflows

Plain text formats have received increasing attention fromscholars in recent years and have been described as among the best ways to store knowledge persistently. This workshop will introduce you to the benefits of using plain text files and simple markup formats to create flexible, robust, and future-proof workflows for digital scholarship, research, and knowlege. We will begin with a brief introduction to the Markdown text format andcreate a short sample document which with the use of a few simple tools that can be converted into a website, dynamic slideshow presentation, PDF, and even a formatted PhD thesis. We will also cover how to migrate existing “closed” files like Word documents and PowerPoint presentations into more accessible plain text Markdown (or similar formats like Asciidoc), for archival, collaboration, version control, and other purposes.

Prerequisites:

* A text editor (note: not a word processor!) that can save in plain text format. A good choice is VSCode https://code.visualstudio.com/.

Helpful, but not required:

* A GitHub.com or Gitlab.com account. We’ll demonstrate how to use GitHub Pages to host a static site. For a more complete introduction to creating static sites with Github Pages, please see the Introduction to Jekyll (https://ubc-library-rc.github.io/intro-jekyll/) workshop.
* Some familiarity with working in a command line / Unix shell interface. Some of the tools we will introduce make use of the command-line, but there are usually alternatives and this is not required. If you’d like to learn more about the command-line shell before you start, please take a look at this workshop Introduction to the Unix Shell (https://ubc-library-rc.github.io/intro-shell/).
* Some familiarity with Git. If you’d like to learn more about Git and GitHub before going any further, please see this workshop: Introduction to Git and Github (https://ubc-library-rc.github.io/intro-git/).

This workshop is part of the Core Skills series.

If you have questions, concerns, or accessibility needs, please email digital.scholarship@ubc.ca.

To keep up-to-date with all our workshops, consults, and events, subscribe to the UBC Library Research Commons monthly newsletter.