From 436c8b743ea9b3ea306760a5aff7334552b04ff0 Mon Sep 17 00:00:00 2001 From: meowrain Date: Wed, 7 Jun 2023 19:51:05 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E5=BF=85=E5=AD=A6=E5=B7=A5=E5=85=B7?= =?UTF-8?q?=E5=A2=9E=E5=8A=A0markdown?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/必学工具/markdown.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 docs/必学工具/markdown.md diff --git a/docs/必学工具/markdown.md b/docs/必学工具/markdown.md new file mode 100644 index 00000000..08b6acd5 --- /dev/null +++ b/docs/必学工具/markdown.md @@ -0,0 +1,28 @@ +# 什么是Markdown + +**Markdown**是一种[轻量级标记语言](https://zh.wikipedia.org/wiki/%E8%BD%BB%E9%87%8F%E7%BA%A7%E6%A0%87%E8%AE%B0%E8%AF%AD%E8%A8%80 "轻量级标记语言"),它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的[XHTML](https://zh.wikipedia.org/wiki/XHTML "XHTML")(或者[HTML](https://zh.wikipedia.org/wiki/HTML "HTML"))文档。 + +由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,目前许多网站都广泛使用Markdown来撰写帮助文档或是用于[论坛](https://zh.wikipedia.org/wiki/%E7%BD%91%E7%BB%9C%E8%AE%BA%E5%9D%9B "网络论坛")上发表消息。 + +> 以上信息来自 +> +> 中文维基百科 https://zh.wikipedia.org/wiki/Markdown + +包括你现在阅读的这份文档,也是用markdown编写完成的。 + +# 编辑器 + +这里推荐两款编辑器: + +- vscode(力荐,免费而且开源,插件库丰富) +- Typora(现在已经是收费软件了,不过可以下载之前的免费版本继续使用) + +# Markdown 语法学习 + +[Markdown 语法指南](https://markdown.com.cn/basic-syntax/) + +看上面的就够了,记住边写边练 + +## 在线练习markdown + +[Arya - 在线 Markdown 编辑器 (lovejade.cn)](https://markdown.lovejade.cn/) From a9a5672f7a759745dd48e408e466608fdf8fc9a5 Mon Sep 17 00:00:00 2001 From: meowrain Date: Thu, 8 Jun 2023 20:37:09 +0800 Subject: [PATCH 2/2] [documentation]Must learn tools to add markdown --- mkdocs.yml | 1 + 1 file changed, 1 insertion(+) diff --git a/mkdocs.yml b/mkdocs.yml index bbeb52c4..2831b456 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -130,6 +130,7 @@ nav: - GitHub: "必学工具/GitHub.md" - "GNU Make": "必学工具/GNU_Make.md" - CMake: "必学工具/CMake.md" + - Markdown: "必学工具/markdown.md" - LaTeX: "必学工具/LaTeX.md" - Docker: "必学工具/Docker.md" - Scoop: "必学工具/Scoop.md"