Markdown

Advanced Software Engineering

Document

  • Documents are fundamental artifacts in software development
    • Requirements
    • Design
    • Manual, etc.
  • Tool/Format
    • MS Office documents
    • Markdown
Advanced Software Engineering

Markdown

  • A lightwight markup language
  • Minimum specifications
    • headline (chapter/section/subsection)
    • Itemize
  • Easy to write source codes
  • Easy to write URL links
Advanced Software Engineering

Headline

Headline level: the number of #

# Chapter

## Section

### Subsection

Advanced Software Engineering

Itemize

Items: Lines beginning with -

- Item 1
    - Item 1.1
        - Item 1.1.1
        - Item 1.1.2
    - Item 1.2
- Item 2
- Item 3
Advanced Software Engineering

Codes

Block of codes: The block srounded by three backquotes

```c
#include <stdio.h>

main() {
    printf("Hello\n");
}
```
Advanced Software Engineering
  • URL links (external links)
[text](URL)
  • Image links
![alt text](URL)
Advanced Software Engineering

Tables

  • Tables in Markdown are created using pipes (|) and dashes (-).
  • The first row defines the headers.
  • The second row sets the alignment.
  • The following rows contain the table data.
| Header 1 | Header 2 |
|----------|----------|
| Cell 1   | Cell 2   |
Advanced Software Engineering

You can align columns using colons (:):

| Left     | Center   | Right    |
|:---------|:--------:|---------:|
| a        |   b      |      c   |

This renders as:

Left Center Right
a b c
Advanced Software Engineering

Ohters

  • Google it
  • Ask it to ChatGPT
Advanced Software Engineering

Summary

  • Markdown is a lightweight markup language
    • Easy to write documents
    • Easy to write code snippets
    • Easy to write URL links
    • Easy to write images
    • Easy to write tables
    • etc.
Advanced Software Engineering