Markdown: lists

1. First
1. Second
    1. nested
    1. nested

1. First
2. Second
   1. nested
   2. nested

Markdown: links

[Drupal](https://www.drupal.org)

Drupal

Markdown: images

![Caption](./images/yp.jpeg)

Markdown: subheadings

### H3 heading

#### H4 heading

##### H5 heading

###### H6 heading

H3 heading

H4 heading

H5 heading

H6 heading

Pandoc: Document converter

• Goal: convert anything to anything
• Method: anything -> markdown -> anything
• https://pandoc.org/

Pandoc: input formats

$ pandoc --list-input-formats
commonmark
creole
docbook
docx
dokuwiki
epub
fb2
gfm
haddock
html
ipynb
jats
json
latex
man
markdown
markdown_github
markdown_mmd
markdown_phpextra
markdown_strict
mediawiki
muse
native
odt
opml
org
rst
t2t
textile
tikiwiki
twiki
vimwiki

Pandoc: output formats

$ pandoc --list-output-formats
asciidoc
asciidoctor
beamer
commonmark
context
docbook
docbook4
docbook5
docx
dokuwiki
dzslides
epub
epub2
epub3
fb2
gfm
haddock
html
html4
html5
icml
ipynb
jats
json
latex
man
markdown
markdown_github
markdown_mmd
markdown_phpextra
markdown_strict
mediawiki
ms
muse
native
odt
opendocument
opml
org
plain
pptx
revealjs
rst
rtf
s5
slideous
slidy
tei
texinfo
textile
zimwiki

Pandoc: usage

$ pandoc \
 --standalone \
 -t revealjs \
 -o html/devops-slides.html \
 markdown/devops-slides.md

Reveal.js: beautiful presentations

• Home page: https://revealjs.com/#/
• GitHub repo: https://github.com/hakimel/reveal.js

GitLab CI: free and flexible

• fully integrated with GitLab
• free for public repositories
• use any Docker image
• jobs and pipelines
• branches, tags, commits

GitLab CI: pages

• Create a job called pages.
• Add files to public/.
• Save it as an artifact.

GitLab CI: example .gitlab-ci.yml

variables:
  GIT_SUBMODULE_STRATEGY: recursive
before_script:
  - apt-get update -qq && apt-get install -qq -y pandoc
  - pandoc --version
pages:
  stage: deploy
  script:
    - make build
    - cp -R html public
  artifacts:
    paths:
      - public

Live Demo: typos

Do not trust your spell checker

• edit
• make
• commit
• push

Copyleft

This slide deck by Benji Fisher is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.
Based on a work at https://gitlab.com/benjifisher/slide-decks.