跳到主要内容

Overview

Markdown 简介

Markdown 是一种轻量级标记语言,旨在以易读易写的纯文本格式编写文档,然后转换为结构化的HTML等格式。它广泛应用于博客、文档、维基等场景,帮助用户专注于内容创作,而无需过多关注格式细节。

Markdown 支持多种扩展语法,如表格、任务列表、脚注等,提升了文档的表达力和可读性

现在各种文档管理软件以及代码托管平台都兼容绝大部分 Markdown 语法,方便用户进行文档的编写和管理

工具和平台

到目前,我的个人Markdown文档和一些笔记经历了多种切换和使用历程

本地存储系

  • Typora
    • 这个是最早接触 Markdown 时使用的,虽然现在收费了,但我认为他还是最简约的 Markdown 编辑器
    • 当然你也可以使用一些手段来免费使用
  • Obsidian
    • 这个是 Typora 收费之后的一个选择,外号黑耀石(因为 logo 长得像)
    • Obsidian 的插件很多,虽然一堆配置下来,使用很强大,但是配置过程个人感觉也相对复杂
    • 没有类似 VSCode 工作区的概念,某个文件夹下的设置不能比较快的复用到另一个文件夹下,貌似没有全局设置
  • MWeb
    • 这个是 MacOS 平台上比较出名的 Markdown 编辑器,功能比较全面,还支持图片快速保存到图床,但是收费

托管文档系

国内厂商

  • Evernote
    • 国内叫印象笔记,我用来记录一些零散的笔记
    • 有个插件叫做剪藏还不错,可以将网页内容快速保存到印象笔记中,防止网页挂了或被删了
  • 有道笔记
    • 这个借助于网易的背景,用户较多
    • 感觉一般,不做好坏评价
    • 有时候找到的一些其他人分享的资料保存到这里的,没在这个上面写过
  • 语雀
    • 这个是阿里推出的文档协作工具,个人觉得功能还不错,支持多人协作,界面简洁
    • 这几年中间宕机过几次,时间还不短,影响使用体验
    • 同样用来保存找到的一些其他人分享的资料,没在这个上面写过
  • 钉钉文档
    • 钉钉推出的文档个人空间功能,开始觉得还不错,但是后面才发现有免费空间限制,所以只能存储较少的文档图片
  • 飞书文档
    • 飞书的文档功能,个人空间免费,存储空间也比较大,支持多人协作,功能迭代快,在国内做企业IM的厂商中,个人觉得其附加的文档功能是目前最好的选择
    • 内置各种画图工具

国外厂商

  • Notion:这个是国外的文档协作工具,功能强大,支持多人协作,个人版免费,用过一段时间,有时候会因为网络原因导致使用起来体验不佳

现在

为了追求:简约够用、轻量、不花哨、不收费,现在我已经回归到最原始的方式

  • 用代码编辑器 IDE 来直接编写 Markdown,不管是博客文章还是零散笔记,偶尔也使用 Typora,图片也不再托管到第三方图床,而是直接存储在本地或私有代码仓库,借助于 Docusaurus 来发布和分享文档
  • 个人有些不便公开的文档存储到本地或者 飞书文档 个人账号中,因为工作也经常用飞书文档,对其非常熟悉
  • 至于其他平台,慢慢都会迁移过来

萝卜青菜,各有所爱,选择适合自己的才是最好的

飞书文档导出为 Markdown

将飞书在线文档导出为 Markdown ,主要有以下两种方式

  • API模式:使用飞书开放平台提供的文档API,将文档读取并转换为 Markdown 格式进行存储

  • 浏览器插件模式:使用浏览器插件,在阅读文档时,将文档转换为 Markdown 格式进行存储