6/14/2023 0 Comments Easy markdown slideshowspptx format and see how the slide deck would translate in Powerpoint. What we tried was to simply convert the markdown file for Deckset into *. Pandoc is a command-line tool for converting files from one markup format to another. Pandoc was brought up as a means of converting the Deckset presentation into an embeddable format, such as a PowerPoint presentation (*. While these options are normally fine, we needed it to be in an embeddable format for our use case of embedding the presentation somewhere else, such as a static site. For specific slides that shouldn’t be text heavy, speaker notes allow the presenter to jot down notes that can only be seen on the presenter’s display.Ī shortcoming that we encountered with Deckset is that it only allows you to export presentations in the following formats: PDF, PDF (reduced file size), JPEG, and PNG. An example Deckset slide written in markup The final slide generated from the markdown.Ī dandy feature that is offered with Deckset is speaker notes. These can be set globally or on a per-slide basis. Their documentation and tutorials are fairly short and easy to follow along with, making it very beginner friendly.ĭeckset has their own configuration commands that belong at the very top of the markdown file as a way of controlling the way your presentation looks and works. Decksetĭeckset is a pretty awesome tool for generating aesthetically pleasing slides using markdown while mainly focusing on the content. This could potentially help developers level up their documentation while also keeping their presentations in source control with the rest of their code. They both use markdown to automatically style and generate a slide deck presentation for you. I’ve had the opportunity to look into two solutions for overcoming this particular challenge: Deckset and Marp. So, what if we could use an already familiar syntax, like that of a README.md, to generate a slide deck in a short amount of time? While this is a good way to document your work, it may not be enough for situations like demos or presentations. For this reason, we have documentation such as a README.md in a GitHub repository. Over time, this can cause difficulty in following along with the project or even how to utilize it. Each new feature added means added complexity to their project or product. For example, I would create one index.Rmd and several Rmd files with meaningful names (e.g., opening.Rmd, intro-github.Rmd, contact.Rmd, etc.When developers are working on a project, their main focus is typically fleshing out a foundation for their code and then building upon this base. To use several source Rmd documents to generate a single Xaringan (or any R Markdown) output, use knitr chunk option child to include other Rmd files in a Rmd document. (Not copy-and-pasting text from the parts you want in one lengthy Rmd file) Your slides can be easily reused, since you can copy a part of your slides by choosing the relevent Rmd file(s). The same idea can be used in Xaringan, and here are some advantages I can think of:īy splitting the source document into several meaningful sub-documents, you can locate particular parts of your slide faster (the so-called “ chunking”). Use Several Source Documentsīookdown uses several Rmd files to generate a book. The idea is simple – reduce the length and complexity of the source R Markdown document. After spending hours on Xaringan, I began to have more faith in making slides with markdown because I figured out some tips to reduce the pain caused by markup langauges. I have been making a lot of slides with Xaringan lately. To be fair, there are great things about making slides with markdown, for example, it’s easier to manage and reuse images through URLs, and markdown is convenient for formatting code (automatic syntax highlighting). I frequently found myself lost in the source document (after scrolling up and down), not knowing which part of the slide is it that I’m looking at 1. When making slides with Markdown, the source document often gets very long. Xaringan::inf_mr() greatly reduces this burden on the brain, but one serious drawback still persists. After using GUI slide making tools such as Powerpoint or Google Slides for years, it is not easy to get used to making slides with markdown, since it requires additional processing in the brain – the conversion between images in the brain and the markup language to create them on the slides. Although I’m a strong believer in R Markdown, I’m not so sure about it in the realm of slide making.
0 Comments
Leave a Reply. |