0.序文
筆者は大学に入学してから数日前までYoudao Cloud Notesを使っています。しかし、Youdaoクラウドサーバーは数日前に突然クラッシュし、午前中にしか修復されなかったため、人々はその安定性と信頼性を疑うようになりました。そこで、オンラインで調べた結果、筆者はgithub+vscodeのマークダウン形式のクラウドノートが自分のニーズに適していると考えています。したがって、初心者が学習して参照できるように、クラウド ノートを設定するプロセスを共有します。
1. 必要なツール
- ビジュアルコード
- Githubリポジトリ
- ギット
2. ツールの準備
2.1 ビジュアルコード
https://code.visualstudio.com/
公式サイトからダウンロードしてインストールするだけです
2.2 Githubリポジトリ
1. 自分でアカウントを登録する
2. 右上隅をクリックして新しい倉庫を作成します
3. 倉庫情報を入力します
4. ウェアハウストークンの取得
-
右上隅の設定をクリックします
-
[開発者設定] をクリックすると、トークンを作成できる個人アクセス トークンが表示されます。
-
情報を入力します。[新しいトークンの生成] をクリックして新しいトークンを作成し、リポジトリを選択すると、それに含まれるすべての項目がチェックされます。次に、一番下までスクロールし、緑色のボタンをクリックしてトークンを生成します。その後、トークンが生成されます。忘れずにコピーして別の場所に保存してください。このトークンは 1 回だけ表示されます。!(以下で使用する必要があります)
2.3 gitのインストールと使用
git を学習して定着させるには 1 ~ 2 日かかります。コンテンツが多く、オンライン チュートリアルも比較的充実しているため、ここでは詳細は説明しません。おすすめの 2 つのコースを紹介します。
- https://www.bilibili.com/video/BV1FE411P7B3?from=search&seid=7622804212840127054狂った神のチュートリアル
- https://www.runoob.com/git/git-tutorial.html Kuang Shen Shuo のチュートリアルは明確で理解しやすいですが、リセットなどの一部の点は詳細に説明されていません。ビデオを見た後は、初心者向けのチュートリアルはわかりません。問題。
3. Visual Codeプラグインの使用上の注意と推奨事項
3.1 新しいメモフォルダーを作成する
-
リポジトリのクローンを作成します (ここで上記の git チュートリアルを学ぶ必要があります)
-
フォルダーをワークスペースに追加
-
メモを書き始めるには、メモとして新しい xxx.md ファイルを作成します。
3.2 プラグインの推奨事項
3.2.1.PicGo
Picgo: 画像を素早くアップロードし、画像の URL を取得するためのツール
-
プラグイン ライブラリで Picgo を検索してインストールします
-
Picgo をクリックしてパラメータ設定ページに入ります
-
github 関連の設定を見つけて、以下に示すように設定します。
-
写真のスクリーンショットを撮り (WeChat QQ コンピューターに付属のものであれば何でも使用できます)、md ファイル内で Ctrl+Alt+U を押して、写真を .md ファイルに貼り付けます。
-
発生する可能性のある問題
設定にエラーがある場合、画像は正常にアップロードされず、次のプロンプトが表示されます。
この時点で、ログ ファイルを開いて、エラーが発生した場所を確認できます。ログ ファイルは、C ドライブのユーザー フォルダー AppData\Roaming\picgo\picgo.log に保存されています。
ログ ファイルを開いてエラーを確認し、解決策を見つけます。
3.2.2 マークダウンリント
markdownlint: vscode 上の非常に便利な Markdown 形式チェック拡張ツールです。多くのルールを規定し、ドキュメント スタイルの統一性を維持しながら、文法上のエラーを防ぐためにリアルタイムでドキュメントをチェックします。このツールを使用すると、良い書き方の習慣と規則を形成するのに役立ちます。
-
上記のように検索してインストールするだけです
-
メモを録音する際に形式を確認したり、メモの形式に誤りがある場合には、その情報をもとにメモを修正したりすることができます。
-
英語が苦手な学生は、https://www.jianshu.com/p/51523a1c6fe1にアクセスして、対応する中国語の説明を参照してください。
3.2.3 マークダウンオールインワン
-
プラグイン マーケットから Markdown All in One をインストールし、有効にします
-
プラグイン
を使用して Markdown ファイルを開き、ctrl+shift+p を押し、「table」と入力してコマンドを検索し、クリックしてディレクトリを作成します
このステップでは、各レベルのタイトルを記述していることが前提となっており、目次を作成することを選択すると、目次が自動的に生成されます。
プラグインのドキュメントに記載されているように- デフォルトでは、ファイルの保存時に目次が自動的に更新されます。無効にするには、toc.updateOnSave オプションを変更してください。
つまり、ファイルを保存すると、プラグインが自動的にディレクトリを保存するため、ディレクトリを一度作成するだけで済み、ディレクトリを作成して直接保存すると自動的に更新されます。
4. いくつかのヒント
4.1 画像サイズの変更
.md ファイルに画像を挿入すると、画像のサイズが固定されるため、画像のサイズを調整したい場合に使用します。HTML言語に置き換えることも可能で、例えば通常の画像コードは以下のようになります。
![20210815224641](https://raw.githubusercontent.com/Logible/note/main/note_image/20210815224641.png)
ハイパーテキスト タグ言語を使用すると、これを次のように変更できます。
<image width=200px height=200px src="https://raw.githubusercontent.com/Logible/note/main/note_image/20210815223056.png" />
ここで、width と height は、指定された画像の幅と高さです。
4.2 画像を独自の行に配置/画像を中央に配置する
上記のコードを次のように変更します
<div align=center>
<image src="https://raw.githubusercontent.com/Logible/note/main/note_image/20210815215806.png" />
</div>
div を使用して行を占有します。ここで、align=center は中央揃えを意味します。
4.3 メモの内容を確認する
メモ内のコンテンツを検索する必要がある場合は、Visual Code の検索機能を使用できます。
4.4 現在作成中のセクションをプレビューする
マークダウン ノートをプレビューしたい場合は、Ctrl+Shift+V を使用して、プレビューしたい部分のサブタイトルをページの上部にスライドさせて、この部分をプレビューします。
たとえば、Unit17 をプレビューしたい場合は、Unit17 をページの一番上にスライドさせ、ショートカット キーを押してプレビューします。
5. 追記
この記事のどこかに間違いがある場合は、ご指摘ください。この記事が役に立った場合は、著者に「いいね」を押してください。
6. 参考記事
https://www.jianshu.com/p/51523a1c6fe1
markdownlint ルールとカスタム パラメーター設定の詳細な紹介
https://blog.csdn.net/qq_44926567/article/details/109167394
markdownlint は一部の HTML タグの警告をキャンセルします
https://www.jianshu.com/p/cb8d2194d5ef
Markdown エディターとしての vscode
https://blog.csdn.net/qq_44486550/article/details/107575128
MarkDown は画像を中央に配置してサイズ変更するように設定します
https://www.jianshu.com/p/a6463f8e8cf8
vscode でマークダウン ファイルを書き込むときの画像の貼り付けの問題