掘金小册 Markdown 转换器使用教程

掘金小册 Markdown 转换器使用教程

juejinxiaoce 项目地址: https://gitcode.com/gh_mirrors/ju/juejinxiaoce

1. 项目介绍

掘金小册 Markdown 转换器是一个开源项目，旨在帮助用户将已购买的掘金小册内容从 HTML 格式转换为 Markdown 格式，并保存到本地。该项目提供了两个版本：

• v2 版本：使用 Node.js 的 https 模块直接获取 HTML 代码，无需使用 Chromium 作为无头浏览器。
• v1 版本：使用 Chromium 作为无头浏览器模拟用户登录网站，获取内容。

项目地址：https://github.com/oliyg/juejinxiaoce

2. 项目快速启动

2.1 安装依赖

首先，确保你已经安装了 Node.js。然后，你可以通过以下命令安装项目依赖：

npm install -g @oliyg/juejinxiaoce

2.2 使用方法

方法一：使用 npx 直接执行

在本地某目录中执行以下命令：

npx @oliyg/juejinxiaoce

按照提示输入用户名、密码以及小册 ID。当提示 all done 时，表示转换完成。

➜ Desktop npx @oliyg/juejinxiaoce
npx: 98 安装成功，用时 10.748 秒
email: 输入你的用户名
password: 输入你的用户名密码
bookId: 小册 ID
===navagating to main page ===login ===getting book section list ===getting book HTML content 面试常用技巧 ===writing html ===getting book HTML content ===write html file success ===writing markdown ===write markdown file success 前方的路，让我们结伴同行 ===writing html ===write html file success ===writing markdown ===write markdown file success ====== All Done, Enjoy ======

方法二：使用 npm i 命令

使用 npm i -g 安装，并使用 juejinxiaoce 命令执行：

➜ Desktop npm i -g @oliyg/juejinxiaoce
/Users/oli/nvm/versions/node/v8.12.0/bin/juejinxiaoce -> /Users/oli/nvm/versions/node/v8.12.0/lib/node_modules/@oliyg/juejinxiaoce/bin/juejinxiaoce
+ @oliyg/juejinxiaoce@2.2.1
added 98 packages from 201 contributors in 5.89s

➜ Desktop juejinxiaoce
email: 输入你的用户名
password: 输入你的用户名密码
bookId: 小册 ID
===navagating to main page ===login ===getting book section list ===getting book HTML content 面试常用技巧 ===writing html ===getting book HTML content ===write html file success ===writing markdown ===write markdown file success 前方的路，让我们结伴同行 ===writing html ===write html file success ===writing markdown ===write markdown file success ====== All Done, Enjoy ======

3. 应用案例和最佳实践

3.1 应用案例

• 技术文档整理：开发者可以将掘金小册的内容转换为 Markdown 格式，方便进行版本控制和文档管理。
• 离线阅读：将小册内容转换为 Markdown 后，可以在无网络的情况下使用 Markdown 阅读器进行阅读。

3.2 最佳实践

• 定期更新：由于掘金小册的内容可能会更新，建议定期使用该工具进行转换，以获取最新内容。
• 备份管理：将转换后的 Markdown 文件进行备份，以防数据丢失。

4. 典型生态项目

• Markdown 编辑器：如 Typora、VSCode 等，用于编辑和查看转换后的 Markdown 文件。
• 版本控制系统：如 Git，用于管理转换后的 Markdown 文件的版本。
• Markdown 阅读器：如 GitBook、MkDocs 等，用于生成静态网站或电子书。

通过这些工具的结合使用，可以进一步提升掘金小册内容的利用效率和价值。

juejinxiaoce 项目地址: https://gitcode.com/gh_mirrors/ju/juejinxiaoce