Skip to main content
Version: Summer 21

Documentation

Markdown is a simple markup language for formatting elements using only plaintext.

There's a few advantages to it over WYSIWYG(What You See Is What You Get) editors such as microsoft word.

  • Simple formatting. Spend time writing instead of fighting margins.
  • No vendor lock in. If the program you're using to display it disappears you still have your writing.
  • Easy to version control.

Here are a few places to learn and reference:

But the best way to learn it is to just use it!

Updating the README​

In the git section we created a README. We've updated our project though and now we need to add how to use our project.

# ag-intro

This will be the second commit
This will be the third commit

## Requirements:

- gnumake

## Getting Started

    git clone https://github.com/<your-github-username>/ag-intro
    cd ag-intro
    make

Let's open a preview of the README in VS Code. Search for the command Markdown: Open Preview to the Side. This is helpful to have up while you're writing to see what the output will be while you get used to the syntax.

Merging a Branch​

info

This is a callback to git in case you skipped over that section!

Git Merge

  1. Checkout the main or master branch.
    • Git: Checkout to... is the command
  2. Search for the command Git: Merge Branch...
  3. When prompted select make
  4. Search for the command git log (You'll need the Git History extension)

R Markdown

We're going to play around with R Markdown, a flavor of markdown that allows execution of R code, and them to be output as reports.

R Markdown Lesson 1

Further Reading