1. Project management¶
In This week, I was assigned a website. I leaned how to Create an account in fablabs.io.
What I learned in this Week 1- MKDocs and MarkDown 2- How to add a local image in markdown? 3- How to add a heading in markdown? 4- What is gitlab? What’s the difference between gitlab and git? 5- What is push and pull and what is the difference between them? 6- How to Clone My website locally on My own device using Git Bash to clone the project repository to my personal laptop, and open the cloned files in Visual Studio Code.
MKDocs/MarkDown¶
For the website designed, I learnd that I well be using MKDocs and MarkDown so what are these?
MKDocs¶
MkDocs is a tool that helps turn simple text written in Markdown into a clean and structured website. It’s mainly used for documentation projects. Instead of manually designing web pages, you just write your content in Markdown, and MkDocs organizes it into a user-friendly site with navigation. It’s lightweight, easy to use, and works well with tools like Git for version control.
Markdown¶
is a lightweight and easy-to-use formatting language for writing plain text. It uses simple symbols (like #, *, or -) to add formatting, such as headings, lists, bold text, or links. For example, you can write # Heading to create a heading or **bold** to make text bold. It’s designed to be readable even in its raw form, making it great for quick documentation or notes.
The Difference between HTML and Markdown:
-
HTML is a full-fledged markup language used to build web pages. It uses tags like
<h1>,<p>, or<a>to structure content and add elements like images, links, and forms. It’s powerful but can be complex and harder to read when writing. -
Markdown is much simpler. It’s not as powerful as HTML but is easier to write and read. For example, in Markdown, you write
# Headinginstead of<h1>Heading</h1>. It’s perfect for quick formatting and is often converted into HTML behind the scenes (like in MkDocs).
In short, HTML is for building full websites, while Markdown is for simpler, faster formatting, especially for documentation or notes.