{"id":17288960,"url":"https://github.com/toniogela/marp","last_synced_at":"2026-01-18T00:21:51.970Z","repository":{"id":110112603,"uuid":"369843871","full_name":"TonioGela/marp","owner":"TonioGela","description":"Custom theme for Markdown presentations with Marp","archived":false,"fork":false,"pushed_at":"2024-04-08T21:43:45.000Z","size":2902,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T22:51:21.855Z","etag":null,"topics":["markdown","marp","presentation-template","slides"],"latest_commit_sha":null,"homepage":"https://marp.toniogela.dev/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TonioGela.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2021-05-22T15:33:31.000Z","updated_at":"2024-04-06T15:16:38.000Z","dependencies_parsed_at":"2024-04-08T22:50:43.379Z","dependency_job_id":null,"html_url":"https://github.com/TonioGela/marp","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TonioGela%2Fmarp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TonioGela%2Fmarp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TonioGela%2Fmarp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TonioGela%2Fmarp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TonioGela","download_url":"https://codeload.github.com/TonioGela/marp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247325648,"owners_count":20920713,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["markdown","marp","presentation-template","slides"],"created_at":"2024-10-15T10:32:53.036Z","updated_at":"2026-01-18T00:21:51.936Z","avatar_url":"https://github.com/TonioGela.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TonioGela's Marp Slides Template\n\nSlides template and theme to be used with [marp-cli], a handy \"Markdown to slides\" tool that features a presenter's view.\n\nThis theme reflects the one built for [my blog](https://toniogela.dev).\n\n![example](./images/example.png)\n\n### Prerequisites\n- [marp-cli](https://github.com/marp-team/marp-cli)\n- [sass] to modify and rebuild the theme (optional)\n- [just] to use the commands defined in the `justfile` (optional)\n- [monolith] to pack the whole presentation in a single html file (optional)\n\n## Instructions\n\nTo write your presentation, create a repository using this template and then:\n- Remove the useless `images/example.png` and `README.md`\n- Fill the `slides.md` file with your content\n\nYou may want to take a look at the many [Marpit Markdown](https://marpit.marp.app/markdown) features.\n\nThe deck of slides can then be built with:\n- `marp --html true --theme-set ./theme/toniogela.css -- slides.md`\n- `marp slides.md` (since there's a `.marprc.yml` file)\n- `just build` (if you have installed `just`)\n\n## Deploy your slides with GH Actions\n\nA custom GH action to easily deploy the deckset is included.\n\nThis action is built to support a single `slides.md` file and a single `images` folder as the only sources for the presentation. It should be difficult to customise if you have different needs.\n\nOnce the repository gets created wait for the CI to complete at least once and then under `Settings \u003e Pages` select `Deploy from a Branch` under `Source` and pick the newly created `gh-pages` `/(root)`.\n\nIf you're using a custom domain you'll need to modify the [cname in the workflow file](./.github/workflows/pages.yml#L41) and setup a corresponding `CNAME` DNS record on your domain to point to `\u003cyour-username\u003e.github.io`.\n\n## Customising the theme\n[slides.md](./slides.md) and [toniogela.scss](./theme/toniogela.scss) should contain all customization instructions. The theme consists of just a few overrides over the default [uncover](https://github.com/marp-team/marp-core/blob/main/themes/uncover.scss) theme and customises the code highlight.\n\nThe file `toniogela.scss` should be compiled to css using [sass](https://sass-lang.com/install) with `sass --no-source-map toniogela.scss:toniogela.css` or `just theme`.\n\nThe repository already contains compiled version for ease.\n\n## justfile\nThe repository contains a `justfile` to use with [just]. You can see the list of recipes running `just`, but the idea is that you can build the presentation using `just build`, bundle it using `just bundle`, get a pdf deckset using `just pdf` and so on.\n\nI encourage you [to take a look at it](./justfile) because maintaining this file is easier than keeping this `README.md` updated.\n\n## Bundling\nTo bundle the whole presentation as a single html file you can use [monolith] running `monolith slides.html --silent --output index.html ` or `just bundle`.\n\n## Graphs\nCool graphs can be drawn using [Asciiflow] and then [converted to images](https://shaky.github.bushong.net/).\n\n## VSCode Plugin\nTo use [the preview feature of VSCode](https://github.com/marp-team/marp-vscode#preview-marp-markdown) install the [VSCode Marp plugin](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode) and set the following properties:\n\n```\n\"markdown.marp.enableHtml\": true,\n\"markdown.marp.themes\": [\"./theme/toniogela.css\"]\n```\nnote that a [settings.json](.vscode/settings.json) is committed into the repo for ease.\n\n## Other\nThe [Marp Github discussions](https://github.com/marp-team/marp/discussions) are really useful in case of doubts.\n\nA list of supported emojis can be found [here](https://github.com/markdown-it/markdown-it-emoji/blob/3.0.0/lib/data/full.mjs).\n\n---\n\nTo concatenate the first two slides I used imagemagick:\n```\nmarp --images png -- slides.md\nmontage slides.001.png slides.002.png -tile x1 -geometry +50+0 -background transparent final.png\nmagick final.png -trim final.png\n```\n\n[marp-cli]: https://github.com/marp-team/marp-cli\n[monolith]: https://github.com/Y2Z/monolith\n[Asciiflow]: https://asciiflow.com/#/\n[just]: https://github.com/casey/just\n[sass]: https://sass-lang.com/install","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoniogela%2Fmarp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoniogela%2Fmarp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoniogela%2Fmarp/lists"}