mirror of
https://gitlab.waag.org/make/fablab/interns/2025/sam.git
synced 2025-08-03 11:54:58 +00:00
2.0 KiB
2.0 KiB
Markdown
What is Markdown
Markdown is a markup language. It's used a lot for documenting because its easy to style and you dont have to struggle with html css when used with Mkdocs or Hugo.
How do I use markdown
Markdown can be used anywhere. You just simple have to create a file that ends with .md
. If you wanna view the markdown that you're writing in vistual studio code you can click the icon below in the top right of your screen.
Styling in markdown
You can syle text by placing different operators around text.
Basic markdown syntax
Text | How to create it |
---|---|
very italic | *a* |
bold | **bold** |
# Head 1 | # Head1 |
## Head 2 | ## Head 2 |
### Head 3 | ### Head 3 |
code |
suround text with ` |
Link | [link](https://www.youtube.com/watch?v=dQw4w9WgXcQ) |
 |
|
Markdown conventions
All markdown files must start with a Head1
otherwise Mkdocs won't understand the file and the pipline will crash.