開発者やライターとして、私たちはドキュメント、ブログ、技術論文を書くために Markdown を使用する必要があることがよくあります。ただし、標準の Markdown 形式は少し普通で、本格的な組版効果が欠けているように見えるかもしれません。ここでは、Markdown ドキュメントに美しいタイポグラフィ効果を簡単に追加できる強力なツールである Markdown Nice (mdnice) を紹介します。
Github アドレス: https://github.com/mdnice/markdown-nice
gitee アドレス: https://gitee.com/zhning12/markdown-nice
オンラインアドレス: https://editor.mdnice.com/
ブロガーのオンライン アドレス: http://mdnice.xiuji.mynatapp.cc/
導入
カスタムスタイルのMarkdownエディタをサポートするオープンソースのノードプロジェクトであり、機能は次のとおりです。
- カスタム スタイルをサポートするマークダウン エディター
- WeChat パブリック アカウントの植字をサポート
- Zhihu、Rare Earth Nuggets、Blog Park、CSDN などの一連のプラットフォームをサポート
- コンテンツとカスタム スタイルはブラウザにリアルタイムで保存されます
- 画像、脚注、数式のアップロードをサポート
展開する
ステップ 1: プロジェクトをダウンロードする
まずプロジェクトを github からサーバーにダウンロードします
ステップ 2: イメージを構築する
プロジェクトの同じディレクトリに Dockerfile ファイルを書き込みます
Dockerfile
# 使用官方Node.js运行时环境作为基础镜像
FROM xj/nodepython:14.16.0-p2
# 维护者信息
MAINTAINER "xj"
# 将项目文件复制到镜像的工作目录中
COPY markdown-nice /app
# 切换工作目录
WORKDIR /app
# 安装项目依赖
RUN npm install
# 暴露容器的HTTP端口
EXPOSE 3000
# 设置启动命令
CMD ["npm", "run", "start"]
Dockerfileと同じディレクトリにイメージをビルドします。
docker build -t xj/mdnice:2.0 .
ビルドが成功したら、次のコマンドを使用してビルドされたイメージを表示できます。
docker images | grep mdnice
ステップ 3: docker-compose.yml ファイルを作成する
docker-compose.yml
version: '3.3'
services:
mdnice:
image: xj/mdnice:2.0
restart: always
ports:
- "8010:3000"
ステップ 4: プロジェクトを開始する
docker-compose.yml と同じディレクトリで次のコマンドを実行します。
docker-compose up -d
ビュー・ログ
docker-compose logs -f
問題がなければ、プロジェクトはすでに開始されています。
機能の説明
私が気に入っている機能のいくつかについて、より具体的に説明しましょう。
- エクスポート機能
- テーマ
- コードテーマ
- 郷土史特集
- コピーとプレビュー機能
マークダウン形式の記事セットは、パブリック アカウント、Zhihu、Nuggets、その他のブログ プラットフォームに同時にコピーでき、プレビューは携帯電話とコンピューターの 2 つの異なるモードに切り替えることもできます。
要約する
Markdown Nice は、通常の Markdown ドキュメントを美しいタイポグラフィを備えた HTML 形式に簡単に変換できる強力なツールです。簡単なコマンド ライン操作で、さまざまなレイアウト スタイルやテーマを選択して、ドキュメントにプロフェッショナルな外観を加えることができます。ブログ、技術論文、ドキュメントを書いている場合でも、Markdown Nice は試してみる価値のあるツールです。
この記事が、Markdown Nice を理解し、それをうまくデプロイして、Markdown ドキュメントをさらに改善するのに役立つことを願っています。