https://github.com/samcunliffe/ucl-talk-template-marp

A minimalist UCL marp slides template for my work talks.
https://github.com/samcunliffe/ucl-talk-template-marp

marp marp-template template ucl ucl-arc

Last synced: 3 months ago
JSON representation

A minimalist UCL marp slides template for my work talks.

• Host: GitHub
• URL: https://github.com/samcunliffe/ucl-talk-template-marp
• Owner: samcunliffe
• License: mit-0
• Created: 2023-12-20T16:10:53.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-10-01T11:34:13.000Z (8 months ago)
• Last Synced: 2025-10-01T13:23:04.853Z (8 months ago)
• Topics: marp, marp-template, template, ucl, ucl-arc
• Homepage: http://scnlf.me/ucl-talk-template-marp/
• Size: 43 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
# UCL talk template with [marp](https://marp.app/)

This is my very minimalist template for UCL talks using [marp](https://marp.app/)/[marpit](https://marpit.marp.app/).  Anyone in UCL is welcome to use the template! If you're not from UCL then please remove the UCL branding. (But at that point, you're just using the default theme!) Anything else (code, infrastructure, etc) is freely reuseable under [MIT-0](./LICENSE.md).

## How to use this template

1. Follow [the instructions for creating a new repository from a template](https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template) (**tl; dr** click on "Use this template").

2. Edit [slides.md](./slides.md) to build your talk. 

    - Follow the excellent [marpit](https://marpit.marp.app/image-syntax) docs for inserting images and backgrounds and split screens etc. Put images in the [assets](./assets) folder.

    - I recommend the [marp-vscode extension](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode) if you use Visual Studio Code.

3. If you push to GitHub there is a [workflow](.github/workflows/marp.yml) to automatically build the talk with [marp-cli](https://github.com/marp-team/marp-cli) and publish the result to a [GitHub pages](https://docs.github.com/en/pages).

    - Go to the repo settings and enable GitHub pages ([follow from step 5 of these instructions](https://docs.github.com/en/pages/getting-started-with-github-pages/creating-a-github-pages-site)), you should then see your slides at `https://yourusername.github.io/name-of-your-talk-repo`.

 If you're not ready or don't want to publish your talk then don't do the final steps.

## Further reading

* [UCL branding instructions](https://www.ucl.ac.uk/staff/external-engagement/brand-and-visual-identity).

* [UCL banner usage rules](https://www.ucl.ac.uk/brand/brand-essentials/ucl-banner).