diff --git a/skills/markdown-to-html/SKILL.md b/skills/markdown-to-html/SKILL.md index cf70ef71..430ad69a 100644 --- a/skills/markdown-to-html/SKILL.md +++ b/skills/markdown-to-html/SKILL.md @@ -7,7 +7,7 @@ description: 'Convert Markdown files to HTML similar to `marked.js`, `pandoc`, ` Expert skill for converting Markdown documents to HTML using the marked.js library, or writing data conversion scripts; in this case scripts similar to [markedJS/marked](https://github.com/markedjs/marked) repository. For custom scripts knowledge is not confined to `marked.js`, but data conversion methods are utilized from tools like [pandoc](https://github.com/jgm/pandoc) and [gomarkdown/markdown](https://github.com/gomarkdown/markdown) for data conversion; [jekyll/jekyll](https://github.com/jekyll/jekyll) and [gohugoio/hugo](https://github.com/gohugoio/hugo) for templating systems. -The conversion script or tool should handles single files, batch conversions, and advanced configurations. +The conversion script or tool should handle single files, batch conversions, and advanced configurations. ## When to Use This Skill diff --git a/skills/markdown-to-html/references/basic-markdown.md b/skills/markdown-to-html/references/basic-markdown.md index 9181c3aa..acb7e890 100644 --- a/skills/markdown-to-html/references/basic-markdown.md +++ b/skills/markdown-to-html/references/basic-markdown.md @@ -16,7 +16,7 @@ To create a heading, add one to six # symbols before your heading tex When you use two or more headings, GitHub automatically generates a table of contents that you can access by clicking the "Outline" menu icon within the file header. Each heading title is listed in the table of contents and you can click a title to navigate to the selected section. -![Screenshot of a README file with the drop-down menu for the table of contents exposed. The table of contents icon is outlined in dark orange.](https://docs.github.comhttps://docs.github.com/assets/images/help/repository/headings-toc.png) +![Screenshot of a README file with the drop-down menu for the table of contents exposed. The table of contents icon is outlined in dark orange.](https://docs.github.com/assets/images/help/repository/headings-toc.png) ## Styling text @@ -45,7 +45,7 @@ Text that is not a quote Quoted text is indented with a vertical line on the left and displayed using gray type. -![Screenshot of rendered GitHub Markdown showing the difference between normal and quoted text.](https://docs.github.comhttps://docs.github.com/assets/images/help/writing/quoted-text-rendered.png) +![Screenshot of rendered GitHub Markdown showing the difference between normal and quoted text.](https://docs.github.com/assets/images/help/writing/quoted-text-rendered.png) > \[!NOTE] > When viewing a conversation, you can automatically quote text in a comment by highlighting the text, then typing R. You can quote an entire comment by clicking , then **Quote reply**. For more information about keyboard shortcuts, see [Keyboard shortcuts](https://docs.github.com/en/get-started/accessibility/keyboard-shortcuts). @@ -252,7 +252,7 @@ Will have a blank line separating both lines You can display an image by adding ! and wrapping the alt text in `[ ]`. Alt text is a short text equivalent of the information in the image. Then, wrap the link for the image in parentheses `()`. -`![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://docs.github.comhttps://myoctocat.com/assets/images/base-octocat.svg)` +`![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://myoctocat.com/assets/images/base-octocat.svg)` ![Screenshot of a comment on a GitHub issue showing an image, added in the Markdown, of an Octocat smiling and raising a tentacle.](https://docs.github.com/assets/images/help/writing/image-rendered.png) diff --git a/skills/markdown-to-html/references/code-blocks.md b/skills/markdown-to-html/references/code-blocks.md index 729c8874..0f9ef2bd 100644 --- a/skills/markdown-to-html/references/code-blocks.md +++ b/skills/markdown-to-html/references/code-blocks.md @@ -31,7 +31,7 @@ Look! You can see my backticks. ![Screenshot of rendered Markdown showing that when you write triple backticks between quadruple backticks they are visible in the rendered content.](https://docs.github.com/assets/images/help/writing/fenced-code-show-backticks-rendered.png) -If you are frequently editing code snippets and tables, you may benefit from enabling a fixed-width font in all comment fields on GitHub. For more information, see [About writing and formatting on GitHub](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github#enabling-fixed-width-fonts-in-the-editor). +If you are frequently editing code snippets and tables, you may benefit from enabling a fixed-width font in all comment fields on GitHub. For more information, see [About writing and formatting on GitHub](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github#enabling-fixed-width-fonts-in-the-editor). ## Syntax highlighting @@ -56,15 +56,15 @@ This will display the code block with syntax highlighting: ![Screenshot of three lines of Ruby code as displayed on GitHub. Elements of the code display in purple, blue, and red type for scannability.](https://docs.github.com/assets/images/help/writing/code-block-syntax-highlighting-rendered.png) > \[!TIP] -> When you create a fenced code block that you also want to have syntax highlighting on a GitHub Pages site, use lower-case language identifiers. For more information, see [About GitHub Pages and Jekyll](https://docs.github.comn/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll#syntax-highlighting). +> When you create a fenced code block that you also want to have syntax highlighting on a GitHub Pages site, use lower-case language identifiers. For more information, see [About GitHub Pages and Jekyll](https://docs.github.com/pages/setting-up-a-github-pages-site-with-jekyll/about-github-pages-and-jekyll#syntax-highlighting). We use [Linguist](https://github.com/github-linguist/linguist) to perform language detection and to select [third-party grammars](https://github.com/github-linguist/linguist/blob/main/vendor/README.md) for syntax highlighting. You can find out which keywords are valid in [the languages YAML file](https://github.com/github-linguist/linguist/blob/main/lib/linguist/languages.yml). ## Creating diagrams -You can also use code blocks to create diagrams in Markdown. GitHub supports Mermaid, GeoJSON, TopoJSON, and ASCII STL syntax. For more information, see [Creating diagrams](https://docs.github.comn/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams). +You can also use code blocks to create diagrams in Markdown. GitHub supports Mermaid, GeoJSON, TopoJSON, and ASCII STL syntax. For more information, see [Creating diagrams](https://docs.github.com/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams). ## Further reading * [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) -* [Basic writing and formatting syntax](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file +* [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file diff --git a/skills/markdown-to-html/references/collapsed-sections.md b/skills/markdown-to-html/references/collapsed-sections.md index b2caf30a..11309e4b 100644 --- a/skills/markdown-to-html/references/collapsed-sections.md +++ b/skills/markdown-to-html/references/collapsed-sections.md @@ -45,4 +45,4 @@ Optionally, to make the section display as open by default, add the `open` attri ## Further reading * [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) -* [Basic writing and formatting syntax](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file +* [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file diff --git a/skills/markdown-to-html/references/tables.md b/skills/markdown-to-html/references/tables.md index ab5e2833..b0581c69 100644 --- a/skills/markdown-to-html/references/tables.md +++ b/skills/markdown-to-html/references/tables.md @@ -29,11 +29,11 @@ Cells can vary in width and do not need to be perfectly aligned within columns. ![Screenshot of a GitHub Markdown table with two columns of differing width. Rows list the commands "git status" and "git diff" and their descriptions.](https://docs.github.com/assets/images/help/writing/table-varied-columns-rendered.png) -If you are frequently editing code snippets and tables, you may benefit from enabling a fixed-width font in all comment fields on GitHub. For more information, see [About writing and formatting on GitHub](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github#enabling-fixed-width-fonts-in-the-editor). +If you are frequently editing code snippets and tables, you may benefit from enabling a fixed-width font in all comment fields on GitHub. For more information, see [About writing and formatting on GitHub](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/about-writing-and-formatting-on-github#enabling-fixed-width-fonts-in-the-editor). ## Formatting content within your table -You can use [formatting](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) such as links, inline code blocks, and text styling within your table: +You can use [formatting](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) such as links, inline code blocks, and text styling within your table: ```markdown | Command | Description | @@ -69,4 +69,4 @@ To include a pipe `|` as content within your cell, use a `\` before the pipe: ## Further reading * [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) -* [Basic writing and formatting syntax](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file +* [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax) \ No newline at end of file diff --git a/skills/markdown-to-html/references/writing-mathematical-expressions-to-html.md b/skills/markdown-to-html/references/writing-mathematical-expressions-to-html.md index ccf60b59..4691850d 100644 --- a/skills/markdown-to-html/references/writing-mathematical-expressions-to-html.md +++ b/skills/markdown-to-html/references/writing-mathematical-expressions-to-html.md @@ -240,7 +240,7 @@ $$\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \ ``` -### Markdwon +### Markdown ```markdown The equation $a^2 + b^2 = c^2$ is the Pythagorean theorem. diff --git a/skills/markdown-to-html/references/writing-mathematical-expressions.md b/skills/markdown-to-html/references/writing-mathematical-expressions.md index 84808b43..ae911f9c 100644 --- a/skills/markdown-to-html/references/writing-mathematical-expressions.md +++ b/skills/markdown-to-html/references/writing-mathematical-expressions.md @@ -12,7 +12,7 @@ Mathematical expressions rendering is available in GitHub Issues, GitHub Discuss ## Writing inline expressions -There are two options for delimiting a math expression inline with your text. You can either surround the expression with dollar symbols (`$`), or start the expression with $\` and end it with \`$. The latter syntax is useful when the expression you are writing contains characters that overlap with markdown syntax. For more information, see [Basic writing and formatting syntax](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax). +There are two options for delimiting a math expression inline with your text. You can either surround the expression with dollar symbols (`$`), or start the expression with $\` and end it with \`$. The latter syntax is useful when the expression you are writing contains characters that overlap with markdown syntax. For more information, see [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax). ```text This sentence uses `$` delimiters to show math inline: $\sqrt{3x-1}+(1+x)^2$ @@ -30,7 +30,7 @@ This sentence uses $\` and \`$ delimiters to show math inline: $`\sqrt{3x-1}+(1+ To add a math expression as a block, start a new line and delimit the expression with two dollar symbols `$$`. -> [!TIP] If you're writing in an .md file, you will need to use specific formatting to create a line break, such as ending the line with a backslash as shown in the example below. For more information on line breaks in Markdown, see [Basic writing and formatting syntax](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#line-breaks). +> [!TIP] If you're writing in an .md file, you will need to use specific formatting to create a line break, such as ending the line with a backslash as shown in the example below. For more information on line breaks in Markdown, see [Basic writing and formatting syntax](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#line-breaks). ```text **The Cauchy-Schwarz Inequality**\ @@ -72,5 +72,5 @@ To display a dollar sign as a character in the same line as a mathematical expre ## Further reading * [The MathJax website](http://mathjax.org) -* [Getting started with writing and formatting on GitHub](https://docs.github.comn/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github) +* [Getting started with writing and formatting on GitHub](https://docs.github.com/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github) * [GitHub Flavored Markdown Spec](https://github.github.com/gfm/) \ No newline at end of file