{"id":13614046,"url":"https://github.com/robalexdev/marp-to-pages","last_synced_at":"2026-01-16T03:43:43.495Z","repository":{"id":39408379,"uuid":"248073400","full_name":"robalexdev/marp-to-pages","owner":"robalexdev","description":"Example marp action","archived":false,"fork":false,"pushed_at":"2023-06-26T01:04:56.000Z","size":19365,"stargazers_count":69,"open_issues_count":3,"forks_count":20,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-10T19:59:57.280Z","etag":null,"topics":["marp-action","template-repository"],"latest_commit_sha":null,"homepage":"https://alexsci.com/marp-to-pages/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robalexdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"publiccode":null,"codemeta":null}},"created_at":"2020-03-17T21:08:04.000Z","updated_at":"2025-04-08T16:47:08.000Z","dependencies_parsed_at":"2024-07-07T00:48:29.308Z","dependency_job_id":null,"html_url":"https://github.com/robalexdev/marp-to-pages","commit_stats":null,"previous_names":["robalexdev/marp-to-pages"],"tags_count":0,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robalexdev%2Fmarp-to-pages","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robalexdev%2Fmarp-to-pages/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robalexdev%2Fmarp-to-pages/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robalexdev%2Fmarp-to-pages/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robalexdev","download_url":"https://codeload.github.com/robalexdev/marp-to-pages/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248760442,"owners_count":21157359,"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":["marp-action","template-repository"],"created_at":"2024-08-01T20:00:56.203Z","updated_at":"2026-01-16T03:43:43.487Z","avatar_url":"https://github.com/robalexdev.png","language":null,"funding_links":[],"categories":["Examples"],"sub_categories":["Community examples"],"readme":"\u003c!--\ntheme: gaia\nclass:\n - invert\nheadingDivider: 2 \npaginate: true\n--\u003e\n\n\u003c!--\n_class:\n - lead\n - invert\n--\u003e\n\n# Deploy Marp to GitHub Pages\n\nPresentations to Webpages: Instantly!\n\n## What?\n\n[Marp](https://marp.app/) lets you create HTML slides from markdown (like this!).\n\nThis presentation is both a [website](https://alexsci.com/marp-to-pages) and a [README.md](https://github.com/ralexander-phi/marp-to-pages/blob/main/README.md).\n\n## Why?\n\nTreat your presentation the same way you treat code.\n\n- Use git to track changes\n- Pull requests to collaborate\n- Deploy automatically\n- See a problem? Open an issue!\n\n## Setup\n\nWant to create your own?\n\nFirst, create a new repo [from the template repo](https://github.com/ralexander-phi/marp-to-pages).\n\n![](img/use-template.png)\n\n## Configure GitHub Pages\n\nOpen your new repo and [setup publishing](https://help.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source).\n\nYou'll typically use `gh-pages` as the deploy branch.\n\n## Review Build\n\nClick on Actions tab and see if the build succeeded (it may take some time).\n\n![](img/click-actions.png)\n\nYou should now see the generated files in the `gh-pages` branch.\n\n## View webpage\n\nOpen your deployed webpage to see the content.\n\nOut of the box you should see `README.md` as `/index.html` and `/README.pdf`. Slides under `docs/` are also converted.\n\n## Running locally\n\nLocally you'll run commands like:\n\n```\n$ marp README.md -o build/README.pdf\n```\n\nor\n\n```\n$ npx @marp-team/marp-cli@latest README.md -o build/README.pdf\n```\n\n## As a workflow step\n\nThe workflow runs an equivalent step:\n\n```\n- name: Marp Build (README.pdf)\n  uses: docker://marpteam/marp-cli:v1.7.0\n  with:\n    args: README.md -o build/README.pdf\n  env:\n    MARP_USER: root:root\n```\n\nNote the `args` match the previous slide.\n\n## Customizing the build\n\nAnything in the `build/` folder will be deployed to GitHub Pages.\n\nYou can copy extra files or run further processing steps using other tools.\n\n## Learn more about Marp\n\nThis is a good time to learn more about Marp. Here's some resources:\n\n- [CommonMark](https://commonmark.org/)\n- [Cheat Sheet](https://commonmark.org/help/)\n- [Themes](https://github.com/marp-team/marp-core/tree/master/themes)\n- [CSS Themes](https://marpit.marp.app/theme-css)\n- [Directives](https://marpit.marp.app/directives)\n- [VS Code plugin](https://marketplace.visualstudio.com/items?itemName=marp-team.marp-vscode)\n\n## Example Sites\n\nKnown sites using this action are:\n\n- [University of Illinois at Urbana-Champaign's CS 199 Even More Practice](https://cs199emp.netlify.app/) [(code)](https://github.com/harsh183/emp-125)\n- [Exploring agent based models](https://roiarthurb.github.io/Talk-UMMISCO_06-07-2020/) [(code)](https://github.com/RoiArthurB/Talk-UMMISCO_06-07-2020)\n\nSend a [pull request](https://github.com/ralexander-phi/marp-to-pages) to get your site added.\n\n## Publish your slides\n\nWhen you are ready to share your presentation, commit or merge to `main` and your content on GitHub Pages will automatically update.\n\n# 🎉\n\u003c!--\n_class:\n - lead\n - invert\n--\u003e\n### Hooray!\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobalexdev%2Fmarp-to-pages","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobalexdev%2Fmarp-to-pages","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobalexdev%2Fmarp-to-pages/lists"}