如何写Markdown格式的文章

Posted 2020-12-21 tom2020

Markdown介绍

什么是Markdown

Markdown是一种纯文本、轻量级的标记语言，常用作文本编辑器使用。和记事本、notepad++相比，Markdown可以进行排版；和Word相比，Markdown排版更容易且文件大小更小；和html相比，Markdown更容易书写。通过Markdown语言写出的文件以.md为后缀结尾，相比于其他编辑器，不会出现乱码等情况，且可以方便的转换为其他格式的文件，如HTML，Word，pdf，图片等等。

为什么选Markdown

Markdown格式无疑是目前最适合网络环境下写作的格式了。它不会因为排版占据大量写作的时间，可以说写作即排版。同时，它已经被许多平台所兼容，比如博客园、简书、知乎、微信公众号、CSDN、腾讯云社区等等，甚至还有github，Gitee等。同时，还可以方便的转换为.htm后缀的文件，可以在浏览器中供读者查看。此外，很多IDE都支持.md文件的编辑和查看，如Atom，PyCharm，IDEA，VSCode，Jupyter等。其外，许多Markdown编辑器也非常方便，如Tom本人使用的为知笔记，就可以使用博客园的API直接将文章进行上传，非常方便。文末附目前为知笔记的.md文档导入博客园随笔的方法。其他主流的Markdown编辑器包括：

• MarkdownPad（Windows，Free） & MarkdownPad Pro（Windows，Charged）官网
• Typora（Windows，Linux，MacOS，Free）官网
• Haroopad（Windows，Linux，MacOS，Free）官网
• Cmd Markdown（Windows，Linux，MacOS，Free）官网
• 马克笔记（android，ios，Free）官网
• MarkdownX （Android，Free）

和HTML兼容

Markdown格式和HTML可以兼容，虽然比HTML的标签少了很多，但是使用起来更加简单。当需要Markdown语言中没有的功能时，无需表明自己正在使用HTML标签，可以直接使用HTML标签进行书写。

Markdown的运用

Markdown语法介绍

标题

Markdown使用#作为标题符，在用户输入的标题前写1-6个#号，就会被认为输入的是1-6级标题。
例：

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

正文

分割线

Markdown使用-、+作为分隔符（不同编辑器略有不同），可以使用连续的三个或以上的加号或减号进行分割线的绘制。也可以使用HTML语言中的<hr/>标签进行分割线的绘制。

例：

引用

Markdown使用>作为引用符，可以在段首加一个>表示此段是引用，也可以使用>>表示引用的嵌套。
例：

别人的旅行再美丽也不是你的，别人的人生再精彩也不能复制。每个人都有做梦的权利和自由，最怕的是，你只会向往别人美丽的光环，却忽略了最重要的是人家会打理自己的人生。我们真正缺少的，不是有意思的人生，而是有意思的能力。

正文加粗

Markdown中，在需要加粗的正文部分的两端加上**就可以表示字体加粗，如果我们要输入*在正文中，可以使用转义字符*进行*的输入。
例：
成功就是一把梯子，双手插在口袋里的人是爬不上去的。

正文斜体

Markdown中，在需要斜体的正文部分的两端加上*就可以表示斜体字。
思想如钻子，必须集中在一点钻下去才有力量

字体前景色

Markdown中，使用标签$color{颜色}{文本1}$来使文本进行变色。
颜色部分可以使用RGB颜色，如$color{#FFCC33}{文本1}$；也可以使用常用颜色，如$color{red}{文本1}$。
例：
很多事先天注定，这是$命$；但你可以决定怎么面对，这是$运$。

字体背景色

Markdown中，默认的字体背景色是用一对==实现的，如==文本1==。背景色默认是高亮的黄色。
也可以使用HTML中的标签进行任意背景色的修改，格式如下：<table><tr><td bgcolor=orange>文本1</td></tr></table>。
例：

勇敢者自有千方百计，怯懦者只感到万般无奈。

无序列表

Markdown中，无序列表可以使用-进行表示。被表示的内容前会出现一个小点，并缩进。
例：

• Python
• Java
• Qt

有序列表

Markdown中，有序列表就是在无序列表的基础上，在-后手动加上数字标号。也可以不需要无序列表标签，手动输入数字标号。
例：

1. mysql
2. MangoDB
3. Redis

删除线

Markdown中，在文本两端加上~~符，会将文本加上删除线。
例：
~~ 要温柔 ~~ ，也要有屠龙的勇气。

下划线

Markdown中，常采用HTML中的<u></u>标签进行下划线的绘制。
例：
人生不是一种享乐，而是一桩十分沉重的工作。

代码

Markdown中，对于嵌在文本中的代码，在代码两端添加反引号符“`”进行代码的书写。对于大段代码，可以在代码的前后两行各使用三个连续的反引号```进行代码块的书写。特别地，可以在首个```后加上代码所用的语言名，会自动识别，关键字高亮显示。

图片和链接

Markdown中，使用![图片底注](URL)的方式进行图片的插入。
Markdown中，使用[文本1](URL)的方式进行文字的超级链接，比图片少一个!号。

表格

为知笔记中，可以直接在Excel中进行编辑，选中需要

尾注

Markdown中，使用[^1]表示第一个尾注，以此类推。

待办

Markdown中，使用- [ ]文本1表示本文1待办，使用- [x]文本2表示文本2已完成。请注意：方括号中有空格。

为知笔记分享博客园API

点击文章标题右边的分享按钮，点击发布到博客，在弹出框中填写相应内容。其中发布网页的API为： http://rpc.cnblogs.com/metaweblog/XXXXXX ，XXXXXX为您的主页，端口默认80，下面依次填写即可。