This version (2024/10/24 10:28) is a draft.
Approvals: 0/1

What is it?

  • Markup language
  • Human readable
  • Machine processable
  • Plaintext
  • Annotion for semantics
  • Highlighting for readability
  • Basis for many homepages, blogs, presentations, plaintext mailinglists, etc
  • It is safe to use a lot of whitespace in markdown, since it won’t show up in the presentation.
  • A single list, block quote, etc should be seperated for readability from other content by an empty line. Most of the time it is optional, but sometimes it’s neccessary.

Write any text, most tools will ignore whitespace variations.

Add an empty line for paragraphs.

To keep line endings
add 2 spaces at the end of the previous line
this will stop the merging of lines
and even works with empty lines. This is still the 3rd paragraph.

Write any text, 
most tools will ignore whitespace variations.

Add an empty line for paragraphs.

To keep line endings  
add 2 spaces at the end of the previous line  
this will stop the merging of lines  
and even works with empty lines. This is still the 3rd paragraph.
  • To make some text italic use _Lorem Ipsum_
  • To make some text bold use __Lorem Ipsum__
  • To make some text bold and italic use ___Lorem Ipsum___
  • To strike through some text use ~~Lorem Ipsum~~

A quote is any text enclosed in single backticks.

A Blockquote is a surrounded by lines with 3 backticks.

This line has a `quoted part`.

```
This is a block quote.

It ignores __syntax__ inside.
```

A Header is Text Prepended by 1 to 7 hash signs

# Largest header - For the main title slide

## Single page header for intermediate title slides

### Header for individual slide, like at the top of this slide

#### This can be used anywhere inside a slide for structure
##### And this
###### And this
####### Smallest header

A regular list is marked by prepending it with a dash.

A numbered list is marked by prepending it with a number and a dot.

1. The first line in a numbered list starts the series.
3. The second number is irrelevant, it will be the successor of the first one
10. And so on. This helps with quickly adding/removing list elements temporarily.
4. of course it is nice, if you correct the sequence after you're done.

- Lists can be nested.
    - But they need to nest 4 spaces deep.

> - Prepending a list with greater-than signs
> - will make it an incrementally apearing list
>     a. and it works for sublists as well
>     c. as you can see
  1. The first line in a numbered list starts the series.
  2. The second number is irrelevant, it will be the successor of the first one
  3. And so on. This helps with quickly adding/removing list elements temporarily.
  4. of course it is nice, if you correct the sequence after you’re done.
  • Lists can be nested.
    • But they need to nest 4 spaces deep.
  • Prepending a list with greater-than signs
  • will make it an incrementally apearing list
    1. and it works for sublists as well
    2. as you can see
  • Tables have fields, which are seperated by a pipe.
  • The header is seperated from the rest of the table by a line of dashes and pipes.
Header 1 | Header 2 | Header 3
---|---|---
Content 1-1 | Content 2-1 | Content 3-1
Content 1-2 | Content 2-2 | Content 3-2
Header 1 Header 2 Header 3
Content 1-1Content 2-1Content 3-1
Content 1-2Content 2-2Content 3-2

VSC 4 Image Links have to parts:

  1. the description
    • enclosed in square brackets
    • may be empty
  2. the URL
    • following the description immediately
    • enclosed by regular brackets
  3. the link to an image can be replaced by the image by prepending an exclamation mark.
    • Note that images are regular in-line elements
    • The source should have a reasonable size or constraints must be added (see next slide)
![VSC 4 Image](https://vsc.ac.at/fileadmin/user_upload/vsc/images/vsc4/vsc-4_300x200.jpg)
[Links](www.vsc.ac.at)
  • Most Blocks can have one or more classes which alter their presentation.
    • These are represented as .classname.
  • Other properties are effectively any valid HTML property.
  • For even more customizability HTML elements may be used.
    • Will be used verbatim in the resulting document.
    • Must match start and end tags manually without breaking the slide hierarchy apart.
    • Useful with custom classes to remove elements from certain output formats.
```{.bash}
This will be highlighted with bash syntax
```

```{.python .numberLines startFrom=5}
This will be highlighted with python syntax.
It will also be numbered.
```

### Fullscreen slide (single picture one picture) {.bigPic}

![](pictures/Test.png)

### Alternative for Wiki only {.dokuwiki}

### Header for Slideshow only {.slidy}

![](pictures/Test.png){.incremental width=100px style="float: left;"}

![](pictures/Test.png){.incremental width=100px style="float: right;"}

<div .incremental .columns>
![](pictures/Test.png){width=100px style="float: left;"}
![](pictures/Test.png){width=100px style="float: right;"}
</div>
  • pandoc/markdown/01_general/markdown.txt
  • Last modified: 2024/10/24 10:28
  • by 127.0.0.1