Learning markdown

[ernestguevarra]

Hello @OxfordIHTM/class-2025!!

This is one of the activities we would have done if our last session for the term was not cut short.

One of the languages we would have learned is the markdown language. This is one of the languages that we use for literate programming. You can read more about literate programming from the slides for today's session - https://oxford-ihtm.io/open-reproducible-science/session5.html#p6.

This is one of the most fun programming languages to learn because it is very simple to learn and use. Some of the basic syntax is shown in today's slides - https://oxford-ihtm.io/open-reproducible-science/session5.html#14 and https://oxford-ihtm.io/open-reproducible-science/session5.html#15.

Some of you may have noticed already also that the comment boxes in GitHub supports Markdown syntax (i.e., you can write Markdown code and it will be rendered accordingly by GitHub.

So, I thought, the best way to learn this is to use this comment/discussion facility here to practice markdown code. We did this last year in the previous class and that was the liveliest class we had. You can see their work in this thread - https://github.com/orgs/OxfordIHTM/discussions/20.

I will use several posts here to show syntax for Markdown. I would encourage all of you to write your own posts with Markdown syntax (including emojis).

[ernestguevarra]

Creating headings

To create headings, we use the # followed by one space and then the line of text. The number of hashes determines the heading hierarchy with the hierarchy going from Heading 1 (largest) to Heading 6 (smallest). The following markdown code:

# Heading 1

## Heading 2

### Heading 3

#### Heading 4

##### Heading 5

###### Heading 6

gives the following results:

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5

Heading 6

[Reem-elsayed]

Hello

Good morning

[Ndayao1]

Is it cold?

Do we need the middle heater on?

No? Okay

[Ellathelight]

Hello

Excited For the Last Class!

[ibrahimAJ-ox]

Good morning

Cover your eyes as you drop your gifts

Please

[angelayxiao]

hello

we made it!

thank you

-Itumeleng

[ernestguevarra]

Styling text

When writing in Word, we are used to styling text as either in bold, in italics, or in bold italics. The following markdown code allows us to do these styles:

Italics: Enclose text with a single asterisk or a single underscore

*italics* or _italics_

which will give this:

italics or italics

Bold: Enclose text with a double asterisk or a double underscore

**bold** or __bold__

which will give this:

bold or bold

Bold italics: Enclose text with a triple asterisk or a triple undersore

***bold-italics*** or ___bold-italics___

which will give this:

bold-italics or bold-italics

Applying this on a sentence or group of sentences:

The *quick brown fox* **jumps** over the ***lazy dog***.

which results in:

The quick brown fox jumps over the lazy dog.

[ibrahimAJ-ox]

No more biscuits

We have eaten all for the year

Merry Christmas

[DrNyasha]

tea and biscuit time....

Approaches :)

[kindrihutami]

Time for mock exam prep holiday

[SimonTiek]

• Hello
• How are you?
• Happy new year in advance

[SimonTiek]

• 1
• 2
• 3
• 4

[ernestguevarra]

Creating bulleted lists

We can create bulleted lists using markdown. We use the asterisk * or the dash - for this purpose as follows.

Bullets using symbols

* Item 1
* Item 2
* Item 3

or

- Item 1
- Item 2
- Item 3

either of which results in this:

• Item 1
• Item 2
• Item 3

Bullets using numbers

1. Item 1
2. Item 2
3. Item 3

which gives this:

1. Item 1
2. Item 2
3. Item 3

Hierarchical lists using bullet symbols

* Item 1
    * Item 1.1
    * Item 1.2
    * Item 1.3
* Item 2
    * Item 2.1
    * Item 2.2
    * Item 2.3
* Item 3
    * Item 3.1
    * Item 3.2
    * Item 3.3  

which creates this output:

• Item 1
  • Item 1.1
  • Item 1.2
  • Item 1.3
• Item 2
  • Item 2.1
  • Item 2.2
  • Item 2.3
• Item 3
  • Item 3.1
  • Item 3.2
  • Item 3.3

Hierarchical list with numbers

1. Item 1
    1.1 Item 1.1
    1.2 Item 1.2
    1.3 Item 1.3
2. Item 2
    2.1 Item 2.1
    2.2 Item 2.2
    2.3 Item 2.3
3. Item 3
    3.1 Item 3.1
    3.2 Item 3.2
    3.3 Item 3.3

which produces this:

1. Item 1
   1.1 Item 1.1
   1.2 Item 1.2
   1.3 Item 1.3
2. Item 2
   2.1 Item 2.1
   2.2 Item 2.2
   2.3 Item 2.3
3. Item 3
   3.1 Item 3.1
   3.2 Item 3.2
   3.3 Item 3.3

Mixed symbol and number hierarchical list

1. Item 1
    * Item 1.1
    * Item 1.2
    * Item 1.3
2. Item 2
    * Item 2.1
    * Item 2.2
    * Item 2.3
3. Item 3
    * Item 3.1
    * Item 3.2
    * Item 3.3 

which results in this:

1. Item 1
   • Item 1.1
   • Item 1.2
   • Item 1.3
2. Item 2
   • Item 2.1
   • Item 2.2
   • Item 2.3
3. Item 3
   • Item 3.1
   • Item 3.2
   • Item 3.3

[angelayxiao]

1. Things I needed to do this weekend
   • Review epi/stats
   • Submit feedback forms
   • Meal prep
2. Things I did this weekend
   • Sleep

[ibrahimAJ-ox]

• Coffee
• No sugar

1. No milk

2. No creamer

3. Coffee

• Black
• No additives

[nqnhao]

Hi, I am Jasmine

My favourite Vietnamese food:

• Banh xeo
• Pho
• Com tam
• Banh trang tron

[Ndayao1]

• To-do-list:

  • Sleep
  • Sleep
  • Eat
  • Sleep

• Repeat

[fonaqorina]

Hi

• To-do-list during the break
  • study for the exam
  • essay social determinants of health
  • TRAVELLING!!!

[ernestguevarra]

Block quotes

> Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce eget augue lacus. Proin 
imperdiet risus vitae purus lacinia ultrices. Nulla blandit aliquam ante, at convallis 
nisl sollicitudin accumsan. Fusce blandit neque odio, quis dictum purus efficitur et. 
Etiam consequat efficitur scelerisque. Curabitur hendrerit aliquet laoreet. Maecenas ultrices 
convallis mauris non convallis. Nam consequat nunc libero, ut vulputate tortor semper ornare.

which creates this:

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Fusce eget augue lacus. Proin imperdiet risus vitae purus lacinia ultrices. Nulla blandit aliquam ante, at convallis nisl sollicitudin accumsan. Fusce blandit neque odio, quis dictum purus efficitur et. Etiam consequat efficitur scelerisque. Curabitur hendrerit aliquet laoreet. Maecenas ultrices convallis mauris non convallis. Nam consequat nunc libero, ut vulputate tortor semper ornare.

[fonaqorina]

this is me trying to survive in IHTM ❤️ 😫

[Reem-elsayed]

Good morning IHTM

[DrNyasha]

I hope I get the biggest gift today lol

bias

non random selection

please

[ibrahimAJ-ox]

There is 🥘 at 🕐

[ernestguevarra]

Inserting images

This is the logo for Oxford iHealth.

![](https://oxford-ihtm.io/images/ihealth_base_pos_sm.png)

which shows up as this:

This is the logo for Oxford iHealth.

[Reem-elsayed]

[Kareemadeenah]

[fonaqorina]

[Reem-elsayed]

[Reem-elsayed]

[ernestguevarra]

Creating a hyperlink

This is a hyperlink to the [Oxford IHTM webpage](https://www.tropicalmedicine.ox.ac.uk/study-with-us/msc-ihtm).

which creates this:

This is a hyperlink to the Oxford IHTM webpage.

[kindrihutami]

Read more about Kirby here

[Ellathelight]

This is a link to the WHT webpage.

[ernestguevarra]

Emojis

GitHub markdown allows for emojis by enclosing an emoji keyword/s with :. An example can be found below:

The quick brown :fox_face: jumps over the lazy :dog:

gives this:

The quick brown 🦊 jumps over the lazy 🐕

or

IHTM Class 2025 :student: :heart: the :snowflake:

gives this

IHTM Class 2025 🧑‍🎓 ❤️ the ❄️

To see a guide of the emoji keywords recognised by GitHub, see [https://gist.github.com/rxaviers/7360908].

[ihtm-bot]

https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md

[Reem-elsayed]

The quick brown 🦊 jumps over the lazy 🐶

[dulanjalees]

😄

[ernestguevarra]

@OxfordIHTM/class-2025 now its your turn. Write text in the comments using a combination of markdown syntax.

[ibrahimAJ-ox]

A big 🙏 for the patience.
Wishing you and the 👪 a very merry 🎄.

[SimonTiek]

Wishing you a Merry Christmas 🤗

[ItumelengB]

[ibrahimAJ-ox]

[ItumelengB]

🎄
❄️
👯