Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Getting started with this repo #1

Open
github-learning-lab bot opened this issue Apr 23, 2018 · 1 comment
Open

Getting started with this repo #1

github-learning-lab bot opened this issue Apr 23, 2018 · 1 comment

Comments

@github-learning-lab
Copy link

Welcome to your repository!

This repository is all about communicating with Markdown. The first thing to know about communicating with Markdown is that Markdown is an easy and widely used way to format your text.

This repository, and all of the activities you complete in it, will be working towards building a static webpage displaying your customized portfolio.

What is Markdown?

Markdown is a lightweight syntax for styling all forms of writing on the GitHub platform and the web. You control the display of the document; formatting words as bold or italic, adding images, and creating lists are just a few of the things we can do with Markdown. Mostly, Markdown is just regular text with a few non-alphabetic characters thrown in, like # or *. You can use Markdown with the toolbar in Issues and Pull Requests, or you can learn the syntax and type it yourself.

You can use Markdown most places around GitHub:

  • Comments in Issues and Pull Requests (like this one!)
  • Files with the .md or .markdown extension
  • Sharing snippets of text in Gists

For more information, see “Writing on GitHub” in the GitHub Help Documentation.

Let's get started!

@github-learning-lab
Copy link
Author

Step 1: Create a Task List

A task list creates checkboxes that can be checked off by collaborators in a given repository. They're very handy for tracking Issues, Pull Requests, and any to-do item.

If you include a task list in the first comment of an Issue, you will get a handy progress indicator in your Issue list. It also works in Pull Requests!

Watch out, because the syntax for task lists is very specific. Be sure to include the spaces where required, or else they won't work.

Example

- [x] @mentions, #refs, [links](url), **formatting**, and <del>tags</del> supported
- [x] list syntax required (any unordered or ordered list supported)
  - Like this
- [x] this is a complete item
- [ ] this is an incomplete item

How it looks

  • @mentions, #refs, links, formatting, and tags supported
  • list syntax required (any unordered or ordered list supported)
    • Like this
  • this is a complete item
  • this is an incomplete item

⌨️ Activity: Add a comment

  1. Add a comment to this issue

  2. Use Markdown to create a task list of todo items. Your task list could include any items you'd like, here's an example you can use:

    - [ ] Turn on GitHub Pages
    - [ ] Outline my portfolio
    - [ ] Introduce myself to the world
    
  3. Use the Preview tab to check your markdown formatting

  4. Click Comment

For a printable version of the steps in this course, check out the Quick Reference Guide.


Watch below your comment for my response

Sometimes I respond too fast for the page to update! If you perform an expected action and don't see a response from me, wait a few seconds and refresh the page for your next steps.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

0 participants