MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] - - PowerPoint PPT Presentation

▶

markdown slides en markdown slides en markdown slides en

MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] - - PowerPoint PPT Presentation

Jul 13, 2023 348 likes •841 views

MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN]

slide-1

SLIDE 1

MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN] MARKDOWN SLIDES [EN]

ADOLFO SANZ DE DIEGO

@ASANZDIEGO

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-2

SLIDE 2

ABOUT

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-3

SLIDE 3

WHAT IS IT?

MarkdownSlides is a Reveal.js and PDF slides generator from MARKDOWN files, that also generate HTML, EPUB and DOCX documents. The idea is that from a same MARKDOWN file we can get slides and books without worrying about style, just worrying about content.

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-4

SLIDE 4

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-5

SLIDE 5

SAMPLES (I)

From a file generate: MARKDOWN reveal-slides reveal-slides-pdf epub-book html-book docx-book pdf-book

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-6

SLIDE 6

SAMPLES (I)

From this same file “plus” files can be generated: MARKDOWN reveal-slides-plus reveal-slides-pdf-plus epub-book-plus html-book-plus docx-book-plus pdf-book-plus

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-7

SLIDE 7

CONTRIBUTORS

Cesar Seoane: Rubén Gómez García: Raul Jimenez Ortega: Pablo J. Triviño: Marcos Chavarría: hps:/ /github.com/cesarseoane hps:/ /github.com/kaneproject hps:/ /github.com/hhkaos hps:/ /twier.com/p_trivino hps:/ /twier.com/chavarria1991

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-8

SLIDE 8

LICENCE

This work is licensed under a: The program source code are licensed under a: Creave Commons Aribuon 3.0 GPL 3.0

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-9

SLIDE 9

INSTALATION

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-10

SLIDE 10

DEPENDENCIES

It needs to be installed: It is automacaly downloaded: Pandoc DeckTape TeX Live Reveal.js

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-11

SLIDE 11

REQUIREMENTS

Now, only works in Linux (may be on MacOS) It can works with Docker, but is in beta.

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-12

SLIDE 12

DOWNLOAD

hps:/ /github.com/asanzdiego/markdownslides/releases

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-13

SLIDE 13

DOCKER

Your installaon with docker is sll under tesng. Any feedback is welcome.

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-14

SLIDE 14

BUILDING DOCKER IMAGE

It will be at dockerhub soon:

$ docker build -t asanzdiego/markdownslides .

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-15

SLIDE 15

LAUNCH THE CONTAINER

Launch the container:

docker run -it -v "${PWD}":/home/markdownslides-master/"${PWD##*/}" \ asanzdiego/markdownslides ./build.sh [clean] [mode] [folder]

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-16

SLIDE 16

HOW TO USE

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-17

SLIDE 17

CREATION

First copy the doc folder and rename it as you like. This is not necessary but helps you organize your documents. Create the md files that you want to generate in the md folder. The md files are files which are nothing more than plain text files with extension md, and a lightweight markup (we should know it but it is very simple). Markdown

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-18

SLIDE 18

IMPORTS (I)

We can add a file with @import import/NOMBRE_FICHERO [startLine=NUMERO] [endLine=NUMERO] [showNumberLines] Firt example: Line 1 of import-2.md Line 2 of import-2.md Line 3 of import-2.md Line 4 of import-2.md

@import import/import-2.md

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-19

SLIDE 19

IMPORTS (II)

Second example: Line 1 of import-1.md Line 2 of import-1.md Line 3 of import-1.md Line 4 of import-1.md

@import import/import-1.md endLine=4

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-20

SLIDE 20

IMPORTS (III)

Third example:

@import import/import-1.md startLine=6

Line 1 of import-2.md
Line 2 of import-2.md
Line 3 of import-2.md
Line 4 of import-2.md

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-21

SLIDE 21

IMPORTS (IV)

Fourth example:

@import import/import-1.md startLine=2 endLine=3 showNumberLines 2 - Line 2 of import-1.md 3 - Line 3 of import-1.md

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-22

SLIDE 22

NOTES

We can add notes that will be visible in book mode or if you press the leer ‘s’ on the slides with @start-notes and @end-notes.

@start-notes This is only visible in book mode or if you press 's' on the slides. @end-notes

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-23

SLIDE 23

PLUS NOTES

We can create notes with @plus that will be only visible in “plus” files as long as in the build.properes we have GENERATE_PLUS_VERSION=‘yes’

@plus the lines below will only be available in the plus version @plus @import import/import-2.md

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-24

SLIDE 24

MATHJAX

We can use the lib. So this: Will be converted to: MathJax

$$x = {-b \pm \sqrt{b^2-4ac}}.$$

x = −b ± √b2 − 4ac.

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-25

SLIDE 25

CODE

function helloWorld() { alert('Hello world'); }

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-26

SLIDE 26

LEVELS

You can have as many levels as you want. Example: But only in books. In slides you can only have 2 levels.

# Level 1 (on slides and book) ## Level 2 (on slides and book) ## Level 3 (in book but stays level 2 in slides)

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-27

SLIDE 27

NUMBERING

You can name several slides with (I), (II), etc. But only the first one will be exported to the book. Example: In the book will be:

## Foo Bar (I) ## Foo Bar (II) ## Foo Bar

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-28

SLIDE 28

CONFIGURATION (I)

We can configure the files that we want to generate from the file build.properes

DEFAULT_GENERATION_MODE='min' GENERATE_PLUS_VERSION='yes' DEFAULT_BUILD='REVEAL_SLIDES_PDF' BUILD_REVEAL_SLIDES='min' BUILD_REVEAL_SLIDES_PDF='med' BUILD_HTML_BOOK='min' BUILD_PDF_BOOK='med' BUILD_DOCX_BOOK='max' BUILD_EPUB_BOOK='max'

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-29

SLIDE 29

CONFIGURATION (II)

We can also configure some other stufs from the file build.properes

CLEAN_LIB_FOLDER='no' COPY_IMG_FOLDER='no' ZIP_EXPORT_FOLDER='no' NUMBER_SECTIONS='no' NUMBER_OFFSET='no' CURRENT_NUMBER_OFFSET=1 REMOVE_GENERATE_MD_FILES='yes'

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-30

SLIDE 30

CONFIGURACIÓN (III)

We can also configure some other stufs aboout reveal.js from the file build.properes

#THEME='black|white|league|sky|beige|simple|serif|blood|night|moon|solarized' REVEAL_JS_THEME='beige' REVEAL_JS_SHOW_TITLE_FOOTER='yes' REVEAL_JS_DEFAULT_TITLE_FOOTER='yes' REVEAL_JS_TITLE_FOOTER="'MarkdownSlides by @asanzdiego :-)'" REVEAL_JS_SHOW_MENU='yes' REVEAL_JS_SHOW_CHALKBOARD='yes' REVEAL_JS_ONLINE='no'

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-31

SLIDE 31

BUILD

In the root folder you have to execute: [mode] can take the next values: min, med o máx. [folder] folder wher to find the md files. If no folder name, it will convert all md files of all the folders.

./build.sh [mode] [folder]

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-32

SLIDE 32

RELEASES NOTES

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-33

SLIDE 33

RELEASE 1.0 (I)

Export slides to: reveal-slides reveal-slides-pdf beamer-slides deck-slides

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-34

SLIDE 34

RELEASE 1.0 (II)

Export books to: html-book docx-book

dt-book

pdf-book

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-35

SLIDE 35

RELEASE 1.0 (III)

Added generaon modes ‘min’, ‘med’ and ‘max’. Automac download the external libraries. Numbering (I), (II), (III) …

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-36

SLIDE 36

RELEASE 2.0 (I)

Export slides to: reveal-slides reveal-slides-pdf reveal-slides-online

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-37

SLIDE 37

RELEASE 2.0 (II)

Export books to: html-book docx-book epub-book

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-38

SLIDE 38

RELEASE 2.0 (III)

Deprecated: beamer-slides deck-slides

dt-book

pdf-book

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-39

SLIDE 39

RELEASE 2.0 (III)

Added menu thanks to . Added dockerfile thanks to . Clean zip files from libraries thanks to . Added type ‘online’ thanks to . Fixed bug HTTPS images thanks to . Loading the online libraries with HTTPS thanks to . Configuraon PDF resoluon thanks to . Raul Jimenez Ortega Rubén Gómez García Cesar Seoane Cesar Seoane Cesar Seoane Cesar Seoane Cesar Seoane

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-40

SLIDE 40

RELEASE 2.0 (IV)

New format ‘epub’. Added ‘bash strict mode’. Added ‘build.properes’ to configure file generaon. Added the command ‘clean’ to clean the lib folder. Download a specific version of external library. Added notes only visible in book mode or if you press ‘s’ on the slides. Normalizaon of images in slides.

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-41

SLIDE 41

RELEASE 3.0

Clean the code. Remove deprecated exportaon files. Improve de configuraon in build.properes file. Update dependencies. Export to PDF with . Book creaon from some md files with enumeraon. Possibility of adding a footer to the slides. Reveal.js DeckTape

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-42

SLIDE 42

RELEASE 4.0

Fix some bugs. Add bookmarks to the slides. Improve file names. Add lib thanks to . MathJax/ Pablo J. Triviño

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-43

SLIDE 43

RELEASE 5.0

Clean the code. Fixed some bugs. Removed the command ‘clean’ to clean the lib folder because it can be done via properes file. Added again the opon to export to PDF in book format. Added the possibility to import files or fragments from an external file. Added the plugin thanks to . Added the possibility to create a ‘plus’ version with extra informaon in slides and books. chalkboard Marcos Chavarría

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-44

SLIDE 44

RELEASE 6.0

Added the possibility to export to PowerPoint. Updated all the libraries to the latest version. Updated the templates. Updated the Dockerfile.

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-45

SLIDE 45

RELEASE 6.*

New image of MarkdownSlides. Added Bootstrap to the html template. Added the DEFAULT_BUILD property. Minor changes.

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-46

SLIDE 46

AUTHOR

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-47

SLIDE 47

ADOLFO SANZ DE DIEGO

Old JEE web developer. Now I’m Tecnical Teacher Advaisor in the TIC service of the General Direcon of Infrastructure and Services of the Ministry of Educaon and Youth of the Community of Madrid. In addion I work as trainer specialized in development technologies.

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-48

SLIDE 48

SOME PROJECTS

: a group created for entrepreneurs and developers who loves hackathons. : an online password manager. : a script to create slides from MD files. Hackathon Lovers Password Manager Generator MarkdownSlides

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego

slide-49

SLIDE 49

WHERE TO FIND ME?

My nick: asanzdiego Blog: GitHub: Twier: LinkedIn: SlideShare: asanzdiego.com github.com/asanzdiego twier.com/asanzdiego linkedin.com/in/asanzdiego slideshare.net/asanzdiego

Markdown Slides [EN] - Adolfo Sanz De Diego - @asanzdiego