WordファイルをMarkdown変換してNotePMにインポート

Word NotePM

この記事ではWordファイルをMarkdown形式に変換してNotePMへ移行するための方法と、プログラムの使い方を紹介します。

URL:WordファイルからNotePMに移行するスクリプト

 

 

ファイル構成について

特定のフォルダの中にWordファイルだけが入っていることとします。フォルダ内のファイルは対象外です。

データのインポート

ではここからWordファイルをNotePMへ取り込む手順を紹介します。まず、プログラムをインストールします。必要なものは次の通りです。

  • Node.js
  • プログラムのインストール
  • アクセストークンの取得

Node.jsのインストール

Node.jsはここからダウンロードできます。ダウンロード後、インストールを実行してください。

プログラムのインストール

プログラムはNode.jsをインストールした環境であれば、次のコマンドでインストールできます。

npm install notepm_importer -g

プログラムはMIT Licenseで公開しています。コードはNotePMMania/notepm_importer: 各種ドキュメント共有サービスからNotePMへ移行するスクリプトにて公開しています。

アクセストークンの取得

NotePMのアクセストークンは個人設定のAPIアクセストークンから取得できます。

そしてアクセストークンを新規作成してください。スコープとして、読み込みと書き込みの両方にチェックを付けてください。

生成されたアクセストークンは、再確認する方法がありません。必ずコピーしたり控えておいてください。

これで準備完了です。

インポートを実行する

ではインポートを実行します。コマンドは次のようになります。

notepm-word \
-p PATH_TO_DIR \
-a ACCESS_TOKEN \
-t TEAM_DOMAIN

内容は次の通りです。

  • PATH_TO_DIR
    Wordファイルが入っているフォルダのパスです
  • ACCESS_TOKEN
    先ほど作成したNotePMのアクセストークンです
  • TEAM_DOMAIN
    NotePMのチームドメインです(例:notepm)

ノートについて

インポートというノートが作成され、その中にすべてのWordファイルがアップロードされます。

項目
ノートの説明 固定「フォルダからインポートしたノート」
スコープ 固定「プライベート」
グループ 設定しません
アイコン 設定しません

ノートはプライベートで作成されます。調整後、公開してください。

ファイルについて

ファイルはすべてNotePMのページとして。内容は次の通りです。

  • 拡張子を除いて、ファイル名をページのタイトルとして利用します
  • 本文はWordファイルの内容をMarkdown化した内容になります
  • 画像は添付ファイルとしてアップロードし、ページ本文に埋め込みます

各ファイルごとに1つのページが作成されます。

注意点

取り込む際の注意点は次の通りです。

  • Wordファイルの本文すべてを再現できる訳ではありません。たとえば表は崩れてしまいます
  • 簡単な文字装飾は再現されますが、色指定などは取り除かれます

コード

URL:WordファイルからNotePMに移行するスクリプト

 

おすすめの情報共有ツール

  • NotePM :テレワーク時代のクラウド型ナレッジ共有ツール