Lab 1 - Learning Markdown
- Lab 1 - Learning Markdown
- Resources
- Question 1 What is Markdown? (10 pts)
- Question 2 Working with Headings and Paragraphs (10 pts)
- Question 3 Working with Lists (10 pts)
- Question 4 Working with Code Formatting (10 pts)
- Question 5 Working with Links and Images (10 pts)
- Question 6 Working with Tables (10 pts)
- Question 7 Challenge Question – Create a Markdown Resume (40 pts)
- Time to submit
Resources
Question 1 What is Markdown? (10 pts)
1. Learn about Markdown:
- Read Slides 1–6
- These slides will help you understand what Markdown is and the formatting options it supports.
- Complete Practice 1 (More Detailed Instructions Below)
- The slides have a summary of the steps. The instructions here are more detailed.
2. Install and Explore VS Code:
- Download and install Visual Studio Code (VS Code).
- Familiarize yourself with the following features:
- How to install an extension
- How to open a folder
- How to create files and folders using the file manager
- How to save files
- ⚠️ Note: We will cover all of this during Practice 1, but reviewing it in advance will help you follow along more easily.
- Here is a nice introduction to VS Code. Watch the video if you want to learn more than what its covered in this lab.
3. Complete Practice 1:
- Follow the detailed instructions provided here to complete Practice 1.
- The slides contain a shorter version of these steps, but this version includes more explanation to help guide you.
Practice 1 (Slides 7–8)
📁 Step 1: Enable File Extensions (Windows Only)
- If you’re using Windows 10 or 11, make sure file extensions (like .md or .pdf) are visible. Some VS Code extensions will not work correctly if file extensions are hidden.
- Windows 10: Enable file extensions
- Windows 11: Enable file extensions
- macOS: No action needed - file extensions are shown by default.
📦 Step 2: Set Up Your Practice Folder
- Download the file lab1.zip.
- Unzip or decompress the file into your Documents folder.
- You should now have a folder called lab1 in Documents.
⚠️ Important: Do not just open the zip file. You must extract it first. If you’re unsure how, watch this video.
💻 Step 3: Open the Folder in VS Code
- Open VS Code.
- Go to File → Open Folder… and open the lab1 folder.
⚠️ Always open a folder in VS Code when working - never just a single file.
🧩 Step 4: Install These VS Code Extensions
- Install the following extensions (search for them in the Extensions panel):
🔍 Step 5: Try the Extensions
1) Markdown PDF:
- Open the file
Ubuntu.md
inside thequestion1
folder. - Right-click on an empty area and choose: Markdown PDF: Export (PDF)
- A file named
Ubuntu.pdf
should appear in the same folder.
2) Markdown Preview Enhanced:
- Right-click on an empty area of
Ubuntu.md
and select: Markdown Preview Enhanced: Open Preview - This lets you check for formatting issues before exporting.
4) PDF Preview:
- Open the newly created
Ubuntu.pdf
file in VS Code. - It should open like a regular PDF viewer.
3. Code Spell Checker:
- This extension highlights spelling mistakes in Markdown or code.
- Optional: You can skip this if you prefer.
⚠️ Note: Make sure to save your markdown file.
Question 2 Working with Headings and Paragraphs (10 pts)
Instructions:
- Read Slides 9–10
- These slides explain how to use headings, bold, and italic formatting in Markdown.
- Complete Practice 2 (More Detailed Instructions Below)
- The slides have a summary of the steps. The instructions here are more detailed.
Practice 2 - Slide 12
Step 1) Rename the File
- Inside the question2 folder, find the file named
homework.txt
. - Rename it to
homework.md
.
Step 2) Apply Heading Formatting
- Format line 1 as a Heading 1: Add
#
at the beginning of the line. - Format line 2 as a Heading 2: Add
##
at the beginning. - Format line 10 as a Heading 3: Add
###
at the beginning.
⚠️ You must add a space after the
#
✅ Preview the file to see the difference between Heading 1, 2, and 3.
Step 3) Bold Formatting
- Make every instance of the word
markdown
bold, except when it appears in a heading. - To do this, wrap the word with double asterisks like so:
**markdown**
(No spaces between the asterisks and the word.)
Step 4) Italic Formatting
- Format the following phrases in italics using single asterisks (
*
):- lightweight markup language
- by John Gruber in 2004
- Websites like Reddit and GitHub support Markdown
Step 5) Bold + Italic Formatting
- Format the following in bold and italics using triple asterisks (***):
- websites, documents, notes, books, presentations, email messages, and technical documentation.
- opened using virtually any application.
- any device running any operating system.
Step 6) Preview the Markdown File
- Right-click in the editor and use Markdown Preview Enhanced to view the formatted document.
- Do you see how each level of formatting looks different?
Question 3 Working with Lists (10 pts)
Instructions
- Read Slides 14–15
- These slides explain how to create unordered (bulleted) and ordered (numbered) lists in Markdown.
- Complete Practice 3
- The presentation has a shorter version of the instructions. Follow the more detailed steps below:
Practice 3
Step 1) Copy Your Previous Work
- Navigate to the
question2
folder. - Copy the file
homework.md
into thequestion3
folder.
Step 2) Create a Bulleted List
- In the
homework.md
file (inside question3), format lines 12 to 20 as a bulleted list:- Start each line with a dash - or an asterisk * followed by a space.
- Remove any empty lines between items.
- Preview the file to check that it displays as a clean bulleted list.
Step 3) Add a Heading and a Numbered List
- Below the bulleted list, add a Heading 2:
## Recommended Markdown Applications
- Then add the following numbered list:
Mac: MacDown, iA Writer, or Marked 2
Windows: ghostwriter or Markdown Monster
Linux: ReText or ghostwriter
⚠️ You can also indent list items by pressing Enter, then Tab, similar to Word.
Step 4) Add a Second Heading and a Nested Bulleted List
- Add another Heading 2:
## Notes Taking Apps
- Then add this bulleted list with indented sub-items (press Tab after hitting Enter to indent):
Linux
Joplin
Obsidian
Windows
Typora
Notion
macOS
Ulysses
Craft
Step 5) Preview Your Markdown
- Use Markdown Preview Enhanced to review your final output.
- Confirm that your headings, bulleted list, numbered list, and indents all appear correctly.
Question 4 Working with Code Formatting (10 pts)
Instructions
- Read Slides 18–19
- These slides explain how to format inline code and code blocks in Markdown.
- Complete Practice 4
Step 1) Open the file
- In the question4 folder, open the file
codeNotes.md
. - This file contains notes about Python, but the code is not yet properly formatted.
- Preview the file to see how it looks before you apply formatting.
Step 2) Format a Code Block (Lines 12 -15)
- Add triple backticks
```
before line 12 and after line 15. - Leave one empty line before the opening backticks and one empty line after the closing backticks.
Step 3) Inline Code Formatting (Lines 19–23)
- Format the following words using inline code by wrapping them in single backticks:
int
,float
,str
,bool
,list
,tuple
,dict
,set
Step 4) Format Another Code Block (Lines 30–43)
- Wrap lines 30–43 with triple backticks to create a code block.
- Again, leave an empty line before and after the code block.
Step 5) Save and Preview
- Save your file.
- Use Markdown Preview Enhanced in VS Code to make sure:
- Inline code appears correctly
- Code blocks are formatted with the correct spacing
- Python code is syntax highlighted (bonus)
Question 5 Working with Links and Images (10 pts)
Instructions
- Read Slides 22–25 and 29
- These slides explain how to insert hyperlinks and images in Markdown.
- Complete Practice 5
Step 1) Open the Provided Files
- Navigate to the
question5
folder. You’ll find:linux.md
- the Markdown file you’ll be editing.Debian_logo.png
- an image file.
- Open
linux.md
in VS Code.
Step 2) Add Hyperlinks
- In the
linux.md
file, locate the words:- Linux
- Linux Kernel
- Linux Distribution
- Linus Torvalds
- Format each of these words as a hyperlink using the appropriate URL listed in the file.
Step 3) Insert Images
- Insert the Linux mascot (Tux) using the URL provided in the
linux.md
file. - Insert the Debian logo (
Debian_logo.png
) from the same folder.
Step 4) Save and Preview
- Save your
linux.md
file. - Use Markdown Preview Enhanced to view the formatted document.
- Check that:
- All hyperlinks work correctly
- Images display properly with spacing
- Alt text shows if the image fails to load
Question 6 Working with Tables (10 pts)
Instructions
- Read Slides 32–34
- These slides explain how to create and format tables in Markdown.
- Complete Practice 6
- The slides contain a summary version of the steps. Follow these detailed instructions below.
Practice 6
Step 1) Open the File
- Navigate to the question6 folder.
- Open the file
pets.md
.
Step 2) Format the Text as a Table
- The file contains unstructured or plain text data about pets.
- Convert that text into a Markdown-formatted table using this syntax:
| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Value A | Value B | Value C |
Make sure: Column headers are clearly labeled. The number of separators (
|
) matches the number of columns. Each row aligns properly under the correct column
Step 3) Align Your Table for Readability
- While spacing between columns doesn’t affect the preview, aligning them in the code improves readability.
- You can use the VS Code extension “Markdown All in One” for automatic table formatting if installed.
Step 4) Save and Preview
- Save your file.
- Use Markdown Preview Enhanced to check that your table renders correctly.
Question 7 Challenge Question – Create a Markdown Resume (40 pts)
Scenario
Your friend, John Doe, has asked you to create a 1-page resume for him. He has provided all of his information in a text file and included a profile picture.
Since you’ve just learned Markdown, you decide to format the resume using Markdown and then export it as a PDF for John.
What to Do
- Navigate to the question7 folder. You will find:
info.txt
- John’s resume contentresume.png
- a preview of the finished PDFjohndoe.jpeg
- john’s profile picture
- Rename info.txt → resume.md
- Format the resume using Markdown
- Use the Markdown skills you’ve learned to format:
- Headings for sections (e.g.,
## Education
) - Bullet points for lists (e.g., skills, experiences)
- Bold and italic text where needed
- An image for John’s profile photo
- Headings for sections (e.g.,
- Use this reference image to guide your formatting:
- Use the Markdown skills you’ve learned to format:
- Preview your Markdown
- Use Markdown Preview Enhanced to check how the resume looks in VS Code.
- Make sure everything fits on one page and is clearly organized.
- Convert to PDF
- Right-click anywhere inside resume.md and select:
- Markdown PDF: Export (PDF)
- This will generate a resume.pdf file in the same folder.
- Compare with the Example
- Open
resume.png
in the question7 folder. - Your exported PDF should look similar to that example.
- Open
- Save Your Work. Double-check that:
resume.md
is saved with all formattingresume.pdf
is properly generated- You didn’t remove any content from the original
info.txt
- John’s profile photo renders in the markdown and the pdf
Time to submit
Create a GITHUB account
- Create a github account using your PCCC email address. Make sure to save your github username, email, and password somewhere safe (like a password manager). You will need it a lot! If you already have a GitHub account, you are allowed to use it.
- Create a public repository called cis106 LOWERCASE PLEASE!
- Here is a video on how to create a github account and repository.
- Do not close the GitHub page, you will need it later.
What will you upload to Github:
The lab1
folder. Every single file must be in your GitHub repository!
Blackboard submission
In blackboard, submit the following:
- The PDF file
resume.pdf
. - The URL of your GitHub Repository. For example, here is mine: https://github.com/linuxworkshop67/cis106
Here is how I will grade you:
- I will go to your github repository, I will check that you complete all the practice from the video that is 60 points.
- I will check that you completed the challenge question that is 40 points. Having the
resume.md
file properly formatted and the pdf file is proof of this. - If I cannot find the files in Github, you will not be awarded a passing grade for this lab.
Regarding Late submissions
Late submissions will be penalized 20 points. See blackboard for due date
Special Note Regarding the final exam:
- You will be required to use markdown during your final exam.
- The final exam is in person.
- The exam is performance based and will require access to a Linux Virtual Machine.
- If you do not have a laptop/computer you can bring to school, a Linux Computer will be made available to you.