markdown终极教程

用markdown写笔记付费是不可能付费的

想白漂那就选开源跨平台的软件

下面的内容都是个人经验

1. markdown教程案例

1.1. 标题

要注意空格与空行, 例如

题目
===

小标题
---

# 一级标题

## 二级标题

### 三级标题

1.2. 列表

可以用- * +三种任意一种, 要注意空格

• 第1节
  • 第1.1节
  • 第1.2节
• 第2节

- 第1节
	- 第1.1节
	- 第1.2节
- 第2节

1.3. 复选框

• 复选框 - [x] 复选框

• 复选框 - [ ] 复选框

1.4. 常用

• 加粗 **加粗**

• 用Esc键下面的~键可得到阴影, 例如 `阴影菌`

• Esc上面加个凸出方框<kbd>Esc</kbd>

• 链接 [链接](https://kz16.top/)

• 书签目录 [TOC]

• 注释 <!--我是注释菌, 你看不见我-->

• 表格找它就对了 https://kz16.top/ckeditor/

  |1|22|333|4444|
  |:--:|:--|--:|--|
  |55555|666666|7|8|
  

  1	22	333	4444
  55555	666666	7	8

• 公式找它就对了 https://kz16.top/latex/symbol/

• 加入代码块, 以Python为例:

  	```python
  	print("hello, python")
  	```
  

  print("hello, python")
  

1. 插入图片的方法一
   ![](https://kz16.top/circle.svg)

2. 插入图片的方法二(该方法同样适用于链接)

   ![][f]
   
   [f]:https://kz16.top/circle.svg
   

3. 插入图片的方法三
   <img src="https://kz16.top/circle.svg" width="50">

4. 上面三种方法都可以得到下面的动图, 要想插入本地图, 可以把图片转为Base64代码, 推荐在线转换 https://kz16.top/png2base64.html

   

5. 链接和图片的区别其实只差一个感叹号

1.5. 段落

第一段第一行, 行尾空两格  
第一段第二行

第二段与第一段要空行

第一段第一行, 行尾空两格
第一段第二行

第二段与第一段要空行

1.6. 字体格式

斜体文本1 斜体文本2
粗体文本1 粗体文本2
粗斜体文本1 粗斜体文本2
下划线文本 删除线文本
变为红色

*斜体文本1*   _斜体文本2_ 
**粗体文本1**  __粗体文本2__ 
***粗斜体文本1***  ___粗斜体文本2___
<u>下划线文本</u>  ~~删除线文本~~
变为<font color="red">红</font>色

1.7. 区块

> 最外层 
> 最外层 
> > 第一层
> > > 第二层

最外层
最外层

第一层

第二层

1.8. 尾注

• 尾注¹

• 尾注²

- 尾注^[我是尾注菌1] 

- 尾注[^尾注菌2] 

[^尾注菌2]: 我是尾注菌2

1.9. 公式

已知$|x|+|y|=0$, 则

$\tag{2} x=y=0$

引用公式(2)的结果

已知$|x|+|y|=0$, 则

<p id="eq2">

$$\tag{2}
x=y=0
$$
<p>

引用公式[(2)](#eq2)的结果

注: markdown做公式标签略微麻烦, <p>标签是为了让公式的链接生效

2. markdown小技巧

2.1. markdown插入图片比较好的一种方案

• 别用图床, 不安全

• 别用图床, 不安全

• 别用图床, 不安全

• 先用这个网站 https://kz16.top/png2base64.html 把图片转成base64代码, 然后插入base64代码这样既可以插入图片又可以保证安全. 但是会带来新问题, base64代码太长怎么办?

• base64代码太长可用折叠方案, 例如VScode可以用标签<!-- #region -->与<!-- #endregion -->

• 或者用marktext编辑器就不存在图片代码过长的问题

2.2. markdown伴侣工具

• 富文本编辑器ckeditor: https://kz16.top/ckeditor/ 支持从word中粘贴带格式的文本和表格, 然后导入到markdown中, 一定要试试

• 在线图片转base64代码 https://kz16.top/png2base64.html, 从根源上解决markdown插图问题.

• mdnice: https://mdnice.com/ 可以把公式转化为svg, 因此用来写邮件和公众号很不错, 要注意部分邮件可能不支持svg图片.

• 常用latex公式 https://kz16.top/latex/symbol/

• mathpix: 在线也有一个markdown, 它的优势有两个, 一个是可以很方便支持同步编写, 另外一个可以识别数学公式.

• 在线表格: https://www.tablesgenerator.com/, 虽然有广告, 但是很强大

• 思维导图 https://app.diagrams.net/

• 数学绘图
  官网网站https://www.geogebra.org/
  中文镜像https://ggb123.cn/
  推荐好用https://geogebra.kz16.top/

• 矢图编辑 https://inkscape.org/

3. 那些年用过的markdown

3.1. 用的第一款markdown

stackedit官网: https://stackedit.io/app#

stackedit个人经验: https://kz16.top/stackedit/

3.1.1. 案例

• 一开始选择它最关键的原因是, 它可以很方便与GeoGebra结合, 生成含有可交互动态图的html文件, 详见视频 . 具体内容见 https://geogebra.kz16.top/ 该页面里的不少链接里的内容是用stackedit写好的

• 后面发现用它写笔记也不错, 笔记链接

• 再后面用它写了一些计算数学相关经验 https://na.kz16.top/, 这个链接里的大部分内容是一天内完成的

3.1.2. 优点

• 无需安装, 打开浏览器就可用, 很方便做笔记, 特别是网上找资料做笔记, 用它准错不了

• 进入界面就是一个很好的教程样例, 无需经验, 打开链接就会写

• 强大的同步功能, 用它同步文档到github或gitlab很方便

• 导出的html书签模板很不错, 很方便电脑查看

• 可以很方便自定义输出模板

• 自动保存

3.1.3. 缺点

• 浏览器中不能很好地和本地建立同步,因此有安全隐患, 清除浏览器记录可能导致所有笔记被删除

• 没有代码折叠

• github上的源码很久没更新了, 希望能好好走下去

3.2. 用的第二款markdown

VScode: https://code.visualstudio.com/

直接用的话不太给力, 需要下载一些插件, 参考这里

• Markdown All in One
• Markdown PDF
• Markdown Preview Enhanced
• Markdown Preview Mermaid Support
• Markdown TOC

3.2.1. 优点

• 写公式相当方便, 因为有提示, 并且非常智能, 体验感很强

• 速度很快, 没出现过卡顿现象

• 支持[toc]添加书签, 并且支持给大小标题自动加序号

• 同步渲染, 定位精准

• 很方便自定义样式, 快捷键Ctrl+Shift+P打开命令面板, 输入Customize CSS, 然后打开style.less就可以自定义样式

• 轻松与github同步

3.4. 其它的一些markdown

用得不多, 所以不做过多评价, 但是都在github点了星星, 毕竟开源不容易

• marktext: 这款软件很不错, 插入片方便, 可以修改图片大小, 据说和typora差不多(typora不开源不曾用过). 导出的html文件样式很方便手机查看

• Notable: 用它分享文档不错, 直接得到链接

• joplin

• zettrl

• boost

3.5. 小结

总之, markdown编辑软件千万别只选一个, 不同的需求用不同的软件. 每款软件都有它优秀的地方, 应该充分利用好它们的优势, 当然要注意下不同软件的兼容问题, 不同编辑器语法会略有不同, 但是大体是兼容的.

本文来源: http://kz16.top/md

欢迎非商用转载, 转载请说明来源

---

1. 我是尾注菌1 ↩︎

2. 我是尾注菌2 ↩︎