将Medium博客迁移到Markdown的神器：medium-2-md

在数字内容创作的世界里，选择一个合适的发布平台至关重要。如果你曾是Medium的忠实用户，但现在希望将你的博客文章转换为更通用和灵活的Markdown格式，那么我有一个好消息要告诉你——medium-2-md，这个命令行工具能帮你轻松实现这一目标。

项目介绍

medium-2-md是一个小巧而强大的CLI工具，它可以将本地的Medium导出文件（HTML）转换为Jekyll或Hugo等支持Markdown的博客系统兼容的Markdown文件。它不仅处理文本转换，还能下载图片，并在转换后的Markdown文件中添加YAML头信息，使得导入到新的博客平台变得更加方便。

项目技术分析

medium-2-md利用了以下技术：

• turndown：这是一个用于将HTML转换为Markdown的库，它能准确地保留原文本的格式。
• cheerio：这个库提供了类似于jQuery的API，用于解析和操作HTML文档，从中提取你需要的信息。
• 命令行工具：使得创建命令行界面变得简单，提供了友好的交互体验。
• js-yaml：用于编写和解析YAML数据，确保Markdown文件的前导元数据正确无误。
• node-fetch：用于下载HTML中的图片到本地，以便在新环境中使用。

通过这些技术的结合，medium-2-md能以高效的自动化方式处理整个迁移过程。

项目及技术应用场景

如果你有以下需求，medium-2-md将派上大用场：

• 想从Medium迁移到自托管的静态博客服务，如Jekyll或Hugo。
• 需要将Medium文章作为独立的Markdown文件存储，便于备份和版本控制。
• 希望在一个统一的Markdown格式下管理和编辑你的所有博客文章。

项目特点

• 一键转换：只需一条命令，即可完成全部文章的转换。
• 包含元数据：生成的Markdown文件带有标题、描述、发布时间和原始链接等元数据。
• 自动下载图片：图片会被保存到本地，Markdown中引用的是本地路径。
• 可定制化：提供多种选项，如指定输出目录、是否包含草稿、自定义图片下载路径等。
• 无需编程经验：即使你不熟悉Node.js，也能轻易上手。

以下是几个使用示例：

• 转换并包含前导信息和图片：

  medium-2-md convertLocal '/path/to/posts' -fi
  

• 默认设置，包含前导信息和图片：

  medium-2-md convertLocal '/path/to/posts' -dfi
  

• 自定义输出和图片路径：

  medium-2-md convertLocal '/path/to/posts' -dfi --path '/custom/output/path' --img-path '/custom/image/path'
  

总的来说，medium-2-md是一个高效且易用的工具，能帮助你无缝迁移你的Medium文章到其他基于Markdown的博客平台。现在就开始吧，让你的内容掌握在自己手中！