Skip to content

docs(G Slides): document how to structure the .md file for the create-from-markdown command #497

@gianpaj

Description

@gianpaj
gog slides create-from-markdown "My Deck" --content-file ./slides.md

the command starts from here
https://github.com/steipete/gogcli/blob/4067cc6e570fdc70d6ef19d1f20a1f0d10b54a82/internal/cmd/slides.go#L26

https://github.com/steipete/gogcli/blob/4067cc6e570fdc70d6ef19d1f20a1f0d10b54a82/internal/cmd/slides_formatter.go#L146
parse here
https://github.com/steipete/gogcli/blob/4067cc6e570fdc70d6ef19d1f20a1f0d10b54a82/internal/cmd/slides_markdown.go#L35
slide is parse here
https://github.com/steipete/gogcli/blob/4067cc6e570fdc70d6ef19d1f20a1f0d10b54a82/internal/cmd/slides_markdown.go#L76

Cloning the source code and asking the AI, I got:


Recommended authoring rules

If you want predictable results, use this checklist:

  • Start each slide with ## Slide Title
  • Separate slides with ---
  • Use plain text paragraphs
  • Use - bullets for lists
  • Use fenced code blocks for code
  • Avoid advanced markdown features

Minimal valid example

## First Slide
Hello world

---
## Second Slide
- One
- Two

With an example: mars.md

## Going to Mars
Why Mars is the next giant step for humanity
- Scientific discovery
- Long-term survival of civilization
- Technology innovation

---
## Why Mars?
Mars is the most Earth-like planet in our solar system.
- It has seasons
- It has water ice
- It has a day length similar to Earth

---
## The Challenges
Getting to Mars is hard.
- Long travel times
- Radiation exposure
- Life support reliability
- Entry, descent, and landing

---
## Mission Architecture
A successful Mars mission needs multiple systems working together.
- Launch vehicles
- Orbital refueling
- Surface habitats
- Power generation
- Return capability

---
## Example Timeline
A human Mars program could unfold in phases.
- Robotic scouting missions
- Cargo delivery
- Short-stay crewed landing
- Permanent surface base

---
## Mars Tech Snapshot
```text
Transit time: 6-9 months
Surface gravity: 38% of Earth
Average temperature: about -63 C
Key requirement: closed-loop life support
gog slides create-from-markdown "Mars: The New Frontier" --content-file mars.md
Created presentation with 6 slides
id	1bnEb7_gvB5SH-xxx
name	Mars: The New Frontier
link	https://docs.google.com/presentation/d/1bnEb7_gvB5SH-xxx/edit?usp=drivesdk
Image

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions