Markdown 编写指南

Markdown 编写指南

Markdown是什么

Markdown是一种可以使用普通文本编辑器编写的标记语言，通过简单的标记语法，它可以使普通文本内容具有一定的格式。(摘自：百度百科)

Q: Markdown可以干什么？

A: 写文档啊！

Q: 为什么要用Markdown？

A: 当然是因为它轻量，书写效率高（不需要设置格式什么的），格式统一，还可以插入代码块、公式、流程图等等，博客、GitHub都支持等等等等，码农必备好嘛！（码农，明明随手写个文用MD也很方便嘛！）

装个Pandoc就可以转word，还可以转pdf，可以转html，加上css生成富文本就可以直接发微信公众号等等。

Markdown适用于：

• 内容大于形式的书写
• 讨厌开word写文档的童鞋：内存占用大卡顿、复杂混乱又不简约的格式、粘贴出错、跨页看着烦等等
• 习惯于用有道笔记/印象笔记管理知识的童鞋
• 喜欢$Latex$这种书写方式，甚至平时爱开记事本写东西的童鞋
• 喜欢黑夜模式书写的
• 你可能是个Mac OS 用户，或是Mac OS + Window用户？

Markdown不适用于：

• 有严格的排版要求
• 复杂的表格设计需求
• 依赖于word插件，如EndNote

基本语法

Markdown在线编辑器马克飞象的示例文档已经展示了基本语法（标题、引用、加粗/斜体、表格、链接/脚注）。打开示例文档看一眼就懂了，一分钟内上手。

标题

# 一级标题
## 二级标题
### 三级标题

目录

@[toc]

字体格式

*我是斜体* 

**我是加粗**

***我是斜体+加粗***

~~我是删除线~~

`我是内联代码`

我是斜体

我是加粗

我是斜体+加粗

我是删除线

我是内联代码

表格

| 左对齐 | 右对齐 | 居中对齐 |
| :----- | -----: | :------: |
| xxx    |    xxx |   xxx    |

链接/引用/脚注

[我是百度链接](https://www.baidu.com/)
>我是引用
在此插入一条脚注[^1] 
[^1]: 我是脚注的内容

我是百度链接

我是引用

在此插入一条脚注¹

代码块

​```代码语言
这里是代码内容
​```

print('Hello World!')

扩展语法

扩展语法的支持因编辑器而异。

以Typora线下编辑器为例，支持以下语法：

公式：$Latex$语法

流程图：flowchart 等

公式（$Latex$语法）

内联公式

即行内的公式

$ $

公式块

$$

$$

插入图片

Markdown插入图片的确不太方便，插入图片是以路径的形式。使用本地路径时管理MD文档中的图片很不方便，因此推荐将图片上传至网络图床。

免费图床首推新浪微博图床

上传工具mac有iPic

windows推荐QQ浏览器插件：新浪图床

安装插件之后，登录微博，直接拖拽图片生成链接（直接提供了Markdown格式的复制哦~）。

工具推荐

Markdown书写有以下几种选择：

1. 有道笔记/印象笔记内置markdown编辑工具
2. 在线编辑工具：推荐马克飞象 https://maxiang.io/
3. 离线编辑工具：推荐Typora（支持Windows/Mac OS，目前免费）https://www.typora.io/

作为一个印象笔记资深用户，我被印象笔记内置的公式编辑器丑哭了，而且对flowchar支持的也不好，已放弃，如今在使用Typora。

Online: 马克飞象

Offline: Typora

官网：https://www.typora.io/

Markdown 可以转成其他格式吗？

1. Word
   安装Pandoc工具之后，就可以用Typora直接导出成 .docx 啦！
2. PDF
   Typora可以直接导出成pdf
3. 还可导出为html、图像等等。

Markdown转微信公众号HTML

好吧，微信公众号只支持HTML+CSS富文本，并不支持Markdown。一段段排版实在太辛苦了。

有没有什么利器咧？

搜罗了一圈，找到几个比较好用的傻瓜工具：

1. Firefox火狐浏览器的Markdown Here插件
2. 在线编辑器Makdown-Weixin：

这些编辑器的优点都是一样的：非常方便，一键将Markdown转换为带CSS的富文本

缺点就是只能使用自带的CSS。Markdown Here支持自定义CSS，Makdown-Weixin并不支持。

如果想要自定义，终极解决方案可能只有自己写CSS了。。。（然鹅本宝宝不会写。。）

如果。。。假设。。。有一个写好的CSS，其实也并不需要插件就可以生成富文本了，只要写在Typora的主题里使用自己写的CSS样式，然后Ctrl+C，到公众号编辑界面Ctrl+V，搞定！

带CSS样式的富文本直接粘贴成功啦。也就是说，只要自己写好CSS，以后发公众号排版只需要两键！！

P.S. 发现秀米公众号编辑器支持一键排版，用的就是Markdown语言。