Markdown 入门

0. 前言

• 定义：Markdown 轻量级标记语言，即输入纯文本，可通过编辑器等转换成html。
• 为什么要用Markdown
  • 首先，强烈建议保持记笔记的习惯，而Markdown是一种非常好的记录笔记方式。
  • 其次，对我个人来说，Markdown 最重要的好处（与word相比）就是：
    • 编辑器好看。
    • 几乎可以不使用鼠标完成笔记的正文输入与格式设置。
  • 最后，Markdown 用于很多地方，如发表博客（如CSDN/知乎）、程序项目文档（如Github）、自建站点（如Hexo）。
• 本文只关注支持Windows系统的编辑器。
  • 因为有大量Markdown编辑器只支持Mac不支持Windows，所以这里提一句。

1. Markdown 基本功能

• Markdown 基本语法提供了一些基本功能，下面分别介绍。
  • 语法具体如何不展开，百度/谷歌一下到处都是。
• 加粗/斜体/删除线/下划线
• 引用（行内引用、块区引用）
• 多级标题
• 无序列表、有序列表
• 代码块
• 超链接、图片链接
• 表格
• 数学公式
• 自动生成目录

2. Makrdown 编辑器需求分析

2.1. 支持代码块/数学公式/快捷键

• 感想：这个属于基本功能，用过的编辑器都支持。

2.2. 导入/分享图片方便

• 从使用角度，希望满足以下功能：
  1. 使用图片外联导入图片（这个基本都满足）；
  2. 能够导入本地图片文件；
  3. 能够使用剪切板导入图片。
• 从功能角度，希望以下功能二选一

图床	优点	缺点
自带图床	使用方便	图片备份需要自行处理，将Markdown转移到其他平台时图片可能不可用
使用第三方图床	数据备份方便	需要编辑器支持（不支持就不能使用），使用相对复杂（需申请/配置OSS空间以及编辑器）

2.3. 美观

• 对我来说最重要。
• 一般 Markdown 编辑器都会提供一些主题，好看不好看就看个人。
• 最好是能够自定义导入CSS的。
  • 虽然我并不会CSS，但这个其他大佬添加新主题

2.4. Markdown 文件转 PDF/HTML

• 为什么需要这个功能？
  • Markdown 自己记笔记、项目中写文档很方便。
  • 但是，作为给领导的汇报材料（一般通过邮件或者微信啥的直接发给领导）很不合适。
• 现有解决方案都不完美，只能凑活着用
  • 转PDF/Word一般都存在排版问题，不好看。
  • 转HTML排版没问题，但并不能解决上面的需求。
  • 转长图片排版没问题，但只适合移动端浏览。
• 实现方式：
  • 一般编辑器都提供了Markdown转HTML的功能，之后可使用Chrome等浏览器的“打印”功能，将HTML 转 PDF（不包括CSS）。
  • 有些提供了pandoc的转换方式，可转换为PDF/图片/Word。

3. Markdown 编辑器与文档管理

• 不同的编辑器有不同的文档管理方式。下面就从文档管理方式角度来分析不同编辑器的功能。

编辑器类型	美观度	编辑器功能	文档管理方式	发布方式	数据备份	多平台数据同步
纯编辑器	高	多	本地文件/文件夹多级自行管理	自建个人博客，功能全、流量低、工作量巨大	方便	麻烦
第三方博客网站	低	少	通过分类/标签单级管理	自带，流量高、互动多、适合知识分享	麻烦	方便
笔记软件	中	中	云端文件/文件夹多级管理	自带，流量低、适合团队协作	麻烦	方便

3.1. 纯编辑器

• 举例：Typora、VSCode等。
• 编辑器本身特点：功能齐全，界面选择多。
• 文档管理方式
  • 本质就是管理本地文件，用多级文件夹自行处理。
  • 一般提供了侧边栏功能，可方便查看本地目录。
  • 文档备份/同步也需要自行处理。
• 发布方式
  • 有大量静态站点生成工具（即个人博客），可将本地的markdown文件生成为网站，比如Hexo/Jekyll/Gitbook等。
  • 优点：界面好看、选择多、功能全。
  • 缺点：需要大量时间捣鼓各种功能（评论、站内搜索、访问量等都需要自己一个一个处理），且如果不是名人基本上没有流量。

3.2. 第三方博客网站

• 举例：CSDN、简书、知乎等
• 编辑器本身特点：普遍功能一般，不好看，基本没有桌面应用
• 文档管理方式：通过分类、标签管理，一般不支持多级分类。
• 发布方式：
  • 自带发布功能。
  • 优点：流量较高，互动较多，适合知识分享。
  • 缺点：功能比较死，不能定制化，不适合团队工作。

3.3. 笔记软件

• 举例：作业部落、语雀、有道云笔记、为知笔记等
• 编辑器本身特点：功能齐全，但主题选择少，不是特别美观。
• 文档管理方式：
  • 按我的理解，就是在云端建立了多级文件夹进行管理。
• 发布方式
  • 一般都有自带发布功能。
  • 优点：一般侧重于团队服务，比如多人协同编辑、文档评审等。
  • 缺点：流量低，不适合知识分享。

4. 个人建议

• 根据不同场景选择不同解决方案
  • 如果笔记软件能够符合自己的需求，且相关缺陷（美观度低、数据备份/迁移麻烦）能够忍受，那就全面使用笔记软件。
  • 如果要自建个人博客，或者喜欢自己捣鼓，那就使用纯编辑器+git备份/同步。
  • 若需要知识分享，则将纯编辑器或笔记软件中的内容导入第三方博客网站中发布。