deck is a tool for creating deck using Markdown and Google Slides.
- Continuous deck building
- Generate and modify deck iteratively.
- Separate content and design
- Markdown for content, Google Slides for design.
- Create (or reuse) a developer project at https://console.cloud.google.com.
- Enable
Google Slides APIandGoogle Drive APIatAPI & Servicespage. - Go to
Credentialspage and click+ CREATE CREDENTIALSat the top. - Create
OAuth client IDtype of credentials. - Choose type
Desktop app. - Download credentials file to
~/.local/share/deck/credentials.json( or${XDG_DATA_HOME}/deck/credentials.json).
Get the presentation ID you want to operate. You can get a list with deck ls.
For example, presentation ID is xxxxxXXXXxxxxxXXXXxxxxxxxxxx of https://docs.google.com/presentation/d/xxxxxXXXXxxxxxXXXXxxxxxxxxxx/edit .
You can create a new presentation with the deck new command and obtain the presentation ID.
If you want to apply a theme, specify the presentation ID of a presentation that is already using that theme with the --from option.
$ deck new --from yyyyyyyYYYYyYYYYYYYyyyyyyyyy --title "Talk about deck"
xxxxxXXXXxxxxxXXXXxxxxxxxxxxThe slide pages are represented by dividing them with horizontal lines ---.
Note
The --- at the beginning of the markdown is ignored.
$ deck apply deck.md --presentation-id xxxxxXXXXxxxxxXXXXxxxxxxxxxxIf your markdown file includes presentationID in the frontmatter, you can use the simplified syntax:
$ deck apply deck.mdYou can use the --watch flag to continuously monitor changes to your markdown file and automatically apply them to the presentation:
$ deck apply --watch deck.md --presentation-id xxxxxXXXXxxxxxXXXXxxxxxxxxxxOr with frontmatter:
$ deck apply --watch deck.mdThis is useful during the content creation process as it allows you to see your changes reflected in the presentation in real-time as you edit the markdown file.
Note
The --watch flag cannot be used together with the --page flag.
deck accepts YAML frontmatter at the beginning of your markdown file.
---
presentationID: xxxxxXXXXxxxxxXXXXxxxxxxxxxx
title: Talk about deck
---
# First Slide
Content...The frontmatter must be:
- At the very beginning of the file
- Enclosed between
---delimiters - Valid YAML syntax
- Use
camelCasefor fields used indecksettings
presentationID: Google Slides presentation ID. When specified, you can use the simplified command syntax.title: title of the presentation. When specified, you can use the simplified command syntax.
Note: This feature is reserved for future enhancements.
deck inserts values according to the following rules regardless of the slide layout.
- The minimum heading level within each slide content is treated as the title and inserted into the title placeholder (
CENTERED_TITLEorTITLE) in order.- In most cases, this will be H1 (
#), which is the standard for slide titles
- In most cases, this will be H1 (
- The next heading level (minimum level + 1) is treated as the subtitle and inserted into the subtitle placeholder (
SUBTITLE) in order.- When H1 is used for titles, H2 (
##) becomes the subtitle
- When H1 is used for titles, H2 (
- All other items are inserted into the body placeholder (
BODY) in order.
For example:
- Standard case: If a slide contains
#(H1), then#becomes title and##becomes subtitle - Alternative case: If a slide only contains
##(H2) or higher, then##becomes title and###becomes subtitle - This allows flexibility in creating slides from various markdown content structures while maintaining familiar heading hierarchies
Note
They are inserted in the order they appear in the markdown document, from the placeholder at the top of the slide (or from the placeholder on the left if the slides are the same height).
# CAP theorem
## In Database theory
## Consistency
Every read receives the most recent write or an error.
## Availability
Every request received by a non-failing node in the system must result in a response.
## Partition tolerance
The system continues to operate despite an arbitrary number of messages being dropped (or delayed) by the network between nodes.- Bold (
**bold**) - Italic (
*italic*__italic__) - List (
-*) - Ordered list (
1.1)) - Link (
[Link](https://example.com)) - Angle bracket autolinks (
<https://example.com>) - Code (
`code`) <br>(for newline)- Image (
)
Create a layout named style and add a Text box to enter specific word. The styles (bold, italic, underline, backgroundColor, foregroundColor, fontFamily) will be applied as the style for each Markdown syntax.
| Word | |
|---|---|
bold |
style for bold. |
italic |
style for italic. |
link |
style for link. |
code |
style for code. |
| (other word) | style for content of inline HTML elements with matching class name ( e.g. <span class="notice">THIS IS NOTICE</span> ) |
By using the --code-block-to-image-command (-c) option, you can convert Markdown code blocks to images. The specified command is executed for each code block, and its standard output is treated as an image.
$ deck apply --code-block-to-image-command "some-command" -i xxxxxXXXXxxxxxXXXXxxxxxxxxxx deck.mdThe command is executed with bash -c.
The command must output image data (PNG, JPEG, GIF) to standard output.
From code blocks like the following, you can obtain the optional language identifier go and the content within the code block.
```go
package main
import "fmt"
func main() {
fmt.Println("Hello, 世界")
}
```
There are three ways to receive code block information within the command:
-
Receive from standard input
- The content of the code block is passed as standard input
- The optional language identifier cannot be obtained, so use it in combination with other methods
-
Receive as environment variables
CODEBLOCK_LANG: Optional language identifier of the code block (e.g.,go,python)CODEBLOCK_CONTENT: Content of the code blockCODEBLOCK_OUTPUT: Path to a temporary output file
-
Receive with template syntax ( with expr-lang )
{{lang}}: Optional language identifier of the code block{{content}}: Content of the code block{{output}}: Path to a temporary output file{{env.XXX}}: Value of environment variable XXX
These methods can be used in combination, and you can choose the appropriate method according to the command requirements.
Note
When {{output}} is not specified, deck reads the image data from the command's stdout. When {{output}} is specified, the command should write the image to that file path, and deck will read the image data from that file.
# Convert Mermaid diagrams to images
$ deck apply -c 'mmdc -i - -o {{output}} --quiet' -i xxxxxXXXXxxxxxXXXXxxxxxxxxxx deck.md# Generate code images with syntax highlighting (e.g., silicon)
$ deck apply -c 'silicon -l {{lang == "" ? "md" : lang}} -o {{output}}' -i xxxxxXXXXxxxxxXXXXxxxxxxxxxx deck.md# Use different tools depending on the language
$ deck apply -c 'if [ {{lang}} = "mermaid" ]; then mmdc -i - -o {{output}} --quiet; else silicon -l {{lang == "" ? "md" : lang}} --output {{output}}; fi' -i xxxxxXXXXxxxxxXXXXxxxxxxxxxx deck.mdThe comments <!-- --> are used as a speaker notes or page config.
If the comment <!-- --> can be JSON-encoded, it will be processed as page config.
<!-- {"layout": "title-and-body"} -->It is possible to specify the page layout.
The layout name (e.g. title-and-body) is specified.
<!-- {"layout": "title-and-body"} -->Tip
With deck ls-layouts it is possible to obtain a list of the layout names for a specific presentation.
$ deck ls-layouts -i xxxxxXXXXxxxxxXXXXxxxxxxxxxx
title
section
section-dark
title-and-body
title-and-body-half
title-and-body-2col
title-and-body-3colIt is possible to skip the operation of the target page.
Tip
If you set it to a page that has been completed with layout and design, the page will not be modified unnecessarily by deck.
<!-- {"freeze": true} -->- zonuexe/deck-slides.el ... Creating deck using Markdown and Google Slides.
By collaborating with AI agents to create Markdown-formatted slides, you may be able to create effective presentations.
For example, it is a good idea to provide the following rules for creating deck slides in the prompt.
Create a presentation in Markdown according to the following rules.
# Rules for describing presentations using Markdown
Unless otherwise specified, please follow the rules below.
- Use `---` to indicate page breaks in slides.
- Within each slide, the minimum heading level will be treated as the title, and the next level as the subtitle. Higher level headings will be treated as body content. It is recommended to use only one title heading per slide.
- The following syntax can be used in the page body. Note that it cannot be used in headings.
- Bold ( `**bold**` )
- Italic ( `*italic*` `__italic__` )
- List ( `-` `*` ) - Ordered list ( `1.` `1)` )
- Link ( `[Link](https://example.com)` )
- Code ( <code>\`code\`</code> )
- `<br>` (for newline)
- Code Block
- Speaker notes for each page should be written in comments ( `<!--` `-->` ). However, if the comment is JSON, it is a page setting, so do not overwrite it. Instead, write the speaker notes in a new comment.
- If the comment ( `<!--` `-->` ) is JSON, it is a page setting. If the value `“freeze”:true` is present, do not modify the page content at all.
homebrew tap:
$ brew install k1LoW/tap/deckgo install:
$ go install github.com/k1LoW/deck/cmd/deck@latestmanually:
Download binary from releases page
- googleworkspace/md2googleslides: Generate Google Slides from markdown
- MIT License
- Include logo as well as source code.
- Only logo license can be selected CC BY 4.0.
- Also, if there is no alteration to the logo and it is used for technical information about deck, I would not say anything if the copyright notice is omitted.