{"id":18881483,"url":"https://github.com/desktop/desktop-markdown-training","last_synced_at":"2025-10-17T23:46:11.208Z","repository":{"id":63377143,"uuid":"566041256","full_name":"desktop/desktop-markdown-training","owner":"desktop","description":null,"archived":false,"fork":false,"pushed_at":"2022-11-26T07:19:12.000Z","size":5926,"stargazers_count":13,"open_issues_count":10,"forks_count":19,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-12-31T03:27:35.915Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/desktop.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-11-14T21:09:58.000Z","updated_at":"2024-11-01T19:10:27.000Z","dependencies_parsed_at":"2023-01-22T14:31:02.460Z","dependency_job_id":null,"html_url":"https://github.com/desktop/desktop-markdown-training","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desktop%2Fdesktop-markdown-training","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desktop%2Fdesktop-markdown-training/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desktop%2Fdesktop-markdown-training/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/desktop%2Fdesktop-markdown-training/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/desktop","download_url":"https://codeload.github.com/desktop/desktop-markdown-training/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239850447,"owners_count":19707348,"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":[],"created_at":"2024-11-08T06:49:37.814Z","updated_at":"2025-10-17T23:46:06.177Z","avatar_url":"https://github.com/desktop.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Markdown and GitHub made easy with GitHub Desktop and VS Code\n\nAre you intimidated by using GitHub? Need to update markdown files in your team's repo and procrastinating? [GitHub Desktop](https://desktop.github.com/) can help! \n\n[GitHub Desktop](https://desktop.github.com/) simplifies git and GitHub and combined with VS Code can make you work life a little bit easier.\n\n- [Markdown and GitHub made easy with GitHub Desktop and VS Code](#markdown-and-github-made-easy-with-github-desktop-and-vs-code)\n  - [ℹ️ About this workshop](#ℹ️-about-this-workshop)\n  - [💻 Prerequisites](#-prerequisites)\n  - [📚 Overview](#-overview)\n    - [:octocat: What is GitHub?](#octocat-what-is-github)\n    - [🖊️ What is Markdown?](#️-what-is-markdown)\n    - [:heart: GitHub + Markdown](#heart-github--markdown)\n  - [:arrow_right: NEXT: Set Up](#arrow_right-next-set-up)\n## ℹ️ About this workshop\n\nThis workshop was created by [@rmw](https://github.com/rmw) for GitHub's internal Day of Learning. It was created in response to hearing how non-engineers sometimes struggled with using GitHub.\n\n## 💻 Prerequisites\n\nThe workshop assumes the following:\n- you have a GitHub account. If not, you can [sign up here](https://github.com/signup).\n- you are using a Mac. \n  - This workshop _should_ work with Windows just fine, but it has not been thoroughly tested.\n\n## 📚 Overview\n\n### :octocat: What is GitHub?\n[GitHub](https://www.github.com) is the productive, collaborative, secure platform that developers love.\n\n**GitHub revolutionaized software engineering.** It made finding, contributing and securing [open source](https://github.com/open-source) software much much easier. GitHub gave engineering teams [tools to get feedback](https://github.com/features/code-review), leading to higher quality and more secure code. It made [automation](https://github.com/features/actions) easier, requiring less resources to focus on things like CI/CD, creating releases and [packages](https://github.com/features/packages), and more. Today, GitHub is automating [security](https://github.com/features/security) and bringing the [power of AI](https://github.com/features/copilot) to development.\n\n\nAnd it can be intimidating for non-software engineers.\n \n\n**It takes a village to build, maintain, secure, deliver, market, and sell software.** This workshop aims to help demystify a common workflow for everyone else.\n\n\u003cimg src=\"https://octodex.github.com/images/benevocats.png\" width=\"400\"\u003e\n\n### 🖊️ What is Markdown?\n\nMarkdown is a lightweight markup language.\n\nLanguage: text that a computer, with the right tools, knows how to turn into something else. In this case, it turns plain text into pretty text.\n\nMarkup: adding special characters (e.g. # or *) to text so that the computer knows how you want to display it. HTML is a also a markup language.\n\nLightweight: not trying to do it all.\n\n**Why is it useful?**\n- Not tied to a specific tool, such as Microsoft Word\n- Simple to use\n- Easy to read even with the special characters\n- GitHub has its own flavor: [GitHub Flavored Markdown or GFM](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github)\n\n### :heart: GitHub + Markdown\nYou can use Markdown in the following places on GitHub:\n- [Issues](https://docs.github.com/en/issues/tracking-your-work-with-issues/about-issues)\n- [Pull Requests](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests)\n- Store markdown (`.md`) files in your repositories. ([Quickstart for writing on GitHub](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/quickstart-for-writing-on-github))\n- [Discussions](https://docs.github.com/en/discussions/quickstart)\n- Comments\n\n ## :arrow_right: [NEXT: Set Up](1-set-up.md)\n\n Let's [get our computer ready](1-set-up.md) to start contributing to open source.\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdesktop%2Fdesktop-markdown-training","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdesktop%2Fdesktop-markdown-training","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdesktop%2Fdesktop-markdown-training/lists"}