{"id":28515632,"url":"https://github.com/devvspaces/communicate-using-markdown","last_synced_at":"2026-01-30T19:33:16.911Z","repository":{"id":52342222,"uuid":"518123775","full_name":"devvspaces/communicate-using-markdown","owner":"devvspaces","description":null,"archived":false,"fork":false,"pushed_at":"2022-08-03T15:54:07.000Z","size":321,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-09T03:06:11.728Z","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":"cc-by-4.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/devvspaces.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}},"created_at":"2022-07-26T15:47:54.000Z","updated_at":"2022-07-26T15:47:54.000Z","dependencies_parsed_at":"2022-09-03T13:41:11.951Z","dependency_job_id":null,"html_url":"https://github.com/devvspaces/communicate-using-markdown","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":"skills/communicate-using-markdown","purl":"pkg:github/devvspaces/communicate-using-markdown","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvspaces%2Fcommunicate-using-markdown","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvspaces%2Fcommunicate-using-markdown/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvspaces%2Fcommunicate-using-markdown/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvspaces%2Fcommunicate-using-markdown/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/devvspaces","download_url":"https://codeload.github.com/devvspaces/communicate-using-markdown/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/devvspaces%2Fcommunicate-using-markdown/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28918221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-30T19:10:10.838Z","status":"ssl_error","status_checked_at":"2026-01-30T19:06:40.573Z","response_time":66,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":"2025-06-09T03:06:11.673Z","updated_at":"2026-01-30T19:33:16.895Z","avatar_url":"https://github.com/devvspaces.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n  \u003c\u003c\u003c Author notes: Header of the course \u003e\u003e\u003e\n  Include a 1280×640 image, course title in sentence case, and a concise description in emphasis.\n  In your repository settings: enable template repository, add your 1280×640 social image, auto delete head branches.\n  Add your open source license, GitHub uses Creative Commons Attribution 4.0 International.\n--\u003e\n\n# Communicate using Markdown\n\n_Organize ideas and collaborate using Markdown, a lightweight language for text formatting._\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Start of the course \u003e\u003e\u003e\n  Include start button, a note about Actions minutes,\n  and tell the learner why they should take the course.\n  Each step should be wrapped in \u003cdetails\u003e/\u003csummary\u003e, with an `id` set.\n  The start \u003cdetails\u003e should have `open` as well.\n  Do not use quotes on the \u003cdetails\u003e tag attributes.\n--\u003e\n\n\u003c!--step0\n\nGitHub is about more than code. It’s a platform for software collaboration, and Markdown is one of the most important ways developers can make their communication clear and organized in issues and pull requests. This course will walk you through creating and using headings more effectively, organizing thoughts in bulleted lists, and showing how much work you’ve completed with checklists. You can even use Markdown to add some depth to your work with the help of emoji, images, and links.\n\n- **Who is this for**: New developers, new GitHub users, and students.\n- **What you'll learn**: Use Markdown to add lists, images, and links in a comment or text file.\n- **What you'll build**: We'll update a plain text file and add Markdown formatting, and you can use this file to start your own GitHub Pages site.\n- **Prerequisites**: In this course you will work with pull requests as well as edit files. If these things aren't familiar to you, we recommend you take the [Introduction to GitHub](https://github.com/skills/introduction-to-github) course, first!\n- **How long**: This course is five steps long and takes less than one hour to complete.\n\n## How to start this course\n\n1. Above these instructions, right-click **Use this template** and open the link in a new tab.\n   ![Use this template](https://user-images.githubusercontent.com/1221423/169618716-fb17528d-f332-4fc5-a11a-eaa23562665e.png)\n2. In the new tab, follow the prompts to create a new repository.\n   - For owner, choose your personal account or an organization to host the repository.\n   - We recommend creating a public repository—private repositories will [use Actions minutes](https://docs.github.com/en/billing/managing-billing-for-github-actions/about-billing-for-github-actions).\n   ![Create a new repository](https://user-images.githubusercontent.com/1221423/169618722-406dc508-add4-4074-83f0-c7a7ad87f6f3.png)\n3. After your new repository is created, wait about 20 seconds, then refresh the page. Follow the step-by-step instructions in the new repository's README.\n\nendstep0--\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 1 \u003e\u003e\u003e\n  Choose 3-5 steps for your course.\n  The first step is always the hardest, so pick something easy!\n  Link to docs.github.com for further explanations.\n  Encourage users to open new tabs for steps!\n--\u003e\n\n\u003cdetails id=1\u003e\n\u003csummary\u003e\u003ch2\u003eStep 1: Add headers\u003c/h2\u003e\u003c/summary\u003e\n\n_Welcome to \"Communicate using Markdown\"! :wave:_\n\n**What is _Markdown_?** Markdown is a [lightweight syntax](https://docs.github.com/github/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) for communicating on GitHub. You can format text to add heading, lists, **bold**, _italics_, tables, and many other stylings. You can use Markdown most places around GitHub:\n\n- Comments in [issues](https://docs.github.com/issues/tracking-your-work-with-issues/about-issues), [pull requests](https://docs.github.com/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/about-pull-requests), and [discussions](https://docs.github.com/discussions/collaborating-with-your-community-using-discussions/about-discussions)\n- Files with the `.md` or `.markdown` extension\n- Sharing snippets of text in [Gists](https://docs.github.com/github/writing-on-github/editing-and-sharing-content-with-gists/creating-gists)\n\n**What is a _header_?** A header is a larger bit of text at the beginning of a section. There are six sizes.\n\n### Example\n\n```txt\n# This is an \u003ch1\u003e header, which is the largest\n## This is an \u003ch2\u003e header\n###### This is an \u003ch6\u003e header, which is the smallest\n```\n\n#### How it looks\n\n# This is an `\u003ch1\u003e` header, which is the largest\n## This is an `\u003ch2\u003e` header\n###### This is an `\u003ch6\u003e` header, which is the smallest\n\n### :keyboard: Activity: Edit your file with headers\n\n1. Open a new browser tab, and work on the steps in your second tab while you read the instructions in this tab.\n1. Open the **pull requests** tab.\n1. Open the pull request we made for you.\n1. In this pull request, go to the **Files changed** tab.\n1. Select **Edit file** from the three dotted **...** menu in the upper right corner of the file view on `index.md`.\n1. On the **Edit file** tab, add a `#`, followed by a **space**, before the content to make it an H1 Header. You can add more headers, using one to six `#` characters followed by a **space**.\n1. Above your new content, click **Preview**.\n1. At the bottom of the page, type a short, meaningful commit message that describes the change you made to the file.\n1. Click **Commit changes**.\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 2 \u003e\u003e\u003e\n  Start this step by acknowledging the previous step.\n  Define terms and link to docs.github.com.\n--\u003e\n\n\u003cdetails id=2\u003e\n\u003csummary\u003e\u003ch2\u003eStep 2: Add an image\u003c/h2\u003e\u003c/summary\u003e\n\n_Great job adding headers to the file :sparkles:_\n\nLet's add an image. Include descriptive text in the square brackets. This text is read aloud for people using screen readers. It's also shown at times when your image doesn't display, such as when there's a poor connection. You can see the syntax for images below:\n\n### Example\n\n```md\n![Image of Yaktocat](https://octodex.github.com/images/yaktocat.png)\n```\n\n#### How it looks\n\n\u003cimg alt=\"Image of Yaktocat\" src=https://octodex.github.com/images/yaktocat.png width=400\u003e\n\n### :keyboard: Activity: Adding an image\n\n1. As you did before, edit the `index.md` file in this pull request.\n1. In the file, add the correct Markdown for your image of choice. Don't forget to include alt-text!\n1. Use the **Preview** tab to check your Markdown formatting.\n1. Commit your changes.\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 3 \u003e\u003e\u003e\n  Start this step by acknowledging the previous step.\n  Define terms and link to docs.github.com.\n--\u003e\n\n\u003cdetails id=3\u003e\n\u003csummary\u003e\u003ch2\u003eStep 3: Add a code example\u003c/h2\u003e\u003c/summary\u003e\n\n_Great job adding an image to the file :tada:_\n\nIn addition to code blocks, some code blocks should be rendered differently depending on the language, such as JavaScript or command-line text.\n\n### Example\n\n\u003cpre\u003e\n```\n$ git init\nInitialized empty Git repository in /Users/skills/Projects/recipe-repository/.git/\n```\n\u003c/pre\u003e\n\n#### How it looks\n\n```\n$ git init\nInitialized empty Git repository in /Users/skills/Projects/recipe-repository/.git/\n```\n\n### :keyboard: Activity: Adding a code example\n\n1. As you did before, edit the file in this pull request.\n1. In the file, add the correct Markdown for a code example of your choice.\n1. Use the **Preview** tab to check your Markdown formatting.\n1. Commit your changes.\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 4 \u003e\u003e\u003e\n  Start this step by acknowledging the previous step.\n  Define terms and link to docs.github.com.\n--\u003e\n\n\u003cdetails id=4\u003e\n\u003csummary\u003e\u003ch2\u003eStep 4: Make a task list\u003c/h2\u003e\u003c/summary\u003e\n\n_Great job adding a code example to the file :partying_face:_\n\n**What is a _task list_?** A task list creates checkboxes to check off. They're very useful for tracking issues and pull requests. If you include a task list in the body of an issue or pull request, you'll see a progress indicator in your issue list. The syntax for task lists is very specific. Be sure to include the spaces where required, or else they won't render.\n\n### Example\n\n```\n- [x] List syntax is required\n- [x] This item is complete\n- [ ] This item is not complete\n```\n\n#### How it looks\n\n- [x] List syntax is required\n- [x] This item is complete\n- [ ] This item is not complete\n\n### :keyboard: Activity: Add a task list\n\nGitHub Actions went ahead and made a branch and a pull request for you. So you'll need to add to the file we've created in the branch, and we will check your work as you work through this course!\n\n1. Return to your pull request.\n1. Use Markdown to create a task list. Here is an example:\n\n   ```md\n   - [ ] Turn on GitHub Pages\n   - [ ] Outline my portfolio\n   - [ ] Introduce myself to the world\n   ```\n\n   Remember, a task list starts with the syntax `- [ ]` and then the task list item. The formatting is specific!\n\n1. Use the **Preview** tab to check your Markdown formatting.\n1. Commit the changes to the file.\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Step 5 \u003e\u003e\u003e\n  Start this step by acknowledging the previous step.\n  Define terms and link to docs.github.com.\n--\u003e\n\n\u003cdetails id=5\u003e\n\u003csummary\u003e\u003ch2\u003eStep 5: Merge your pull request\u003c/h2\u003e\u003c/summary\u003e\n\n_Great job adding a task list to the file :heart:_\n\nYou can now [merge](https://docs.github.com/get-started/quickstart/github-glossary#merge) your pull request!\n\n### :keyboard: Activity: Merge your pull request\n\n1. Click **Merge pull request**.\n1. Wait about 20 seconds then refresh this page for the next step.\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Finish \u003e\u003e\u003e\n  Review what we learned, ask for feedback, provide next steps.\n--\u003e\n\n\u003cdetails id=X open\u003e\n\u003csummary\u003e\u003ch2\u003eFinish\u003c/h2\u003e\u003c/summary\u003e\n\n_Congratulations friend, you've completed this course!_\n\n\u003cimg src=https://octodex.github.com/images/welcometocat.png alt=celebrate width=300 align=right\u003e\n\nHere's a recap of all the tasks you've accomplished in your repository:\n\n1. You learned about Markdown, headings, images, code examples, and task lists.\n1. You created and merged a Markdown file.\n1. You learned an essential GitHub skill. 🎉\n\n### What's next?\n\n- You can enable GitHub Pages and see your Markdown file as a website!\n  1. Under your repository name at the upper right, click :gear: **Settings**.\n  1. Then on the lower left, click **Pages**.\n  1. In the **GitHub Pages** section, use the **Source** drop-down menu to select `main` as your GitHub Pages publishing source.\n  1. Click the **Save** button.\n  1. Wait about 30 seconds then refresh the page. When you see \"Your site is published at ...\" you can click on the link to see your published site.\n- Learn more about [Markdown](https://docs.github.com/github/writing-on-github).\n- We'd love to hear what you thought of this course [in our discussion board](https://github.com/skills/.github/discussions)\n- [Take another GitHub Skills course](https://github.com/skills).\n- [Read the GitHub Getting Started docs](https://docs.github.com/get-started).\n- To find projects to contribute to, check out [GitHub Explore](https://github.com/explore).\n\n\u003c/details\u003e\n\n\u003c!--\n  \u003c\u003c\u003c Author notes: Footer \u003e\u003e\u003e\n  Add a link to get support, GitHub status page, code of conduct, license link.\n--\u003e\n\n---\n\nGet help: [Post in our discussion board](https://github.com/skills/.github/discussions) \u0026bull; [Review the GitHub status page](https://www.githubstatus.com/)\n\n\u0026copy; 2022 GitHub \u0026bull; [Code of Conduct](https://www.contributor-covenant.org/version/2/1/code_of_conduct/code_of_conduct.md) \u0026bull; [CC-BY-4.0 License](https://creativecommons.org/licenses/by/4.0/legalcode)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevvspaces%2Fcommunicate-using-markdown","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdevvspaces%2Fcommunicate-using-markdown","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdevvspaces%2Fcommunicate-using-markdown/lists"}