nDiki : Markdown

Markdown

計量マークアップ言語の1つ。

GitHub では GitHub Flavored Markdown (GFM) という Markdown 方言を使っている。

スポンサード リンク

2019年5月29日 (水)

今日のさえずり: ムーンクレスタ、ドッキング失敗の悲しい記憶が甦った

2019年05月29日

[ 5月29日全て ]

2019年5月30日 (木)

one-on-one ミーティングノート形式

one-on-one ミーティングにあたっては相手と自分のみ閲覧・編集できるノート(アジェンダ)を用意している。

ここ数年は Google ドキュメントを使っていて、半期(半年)毎に1ドキュメント作成してそこに書くようにしている。そこに毎週(あるいは隔週)の one-on-one ミーティング前に日別の見出しを作って下に追記していっている(新しい日を上に追加していく方がスクロールせずに書き始められて楽なんだけれど見返す際に日付順の方が圧倒的に見やすい)。

今使っている形式は以下(表現上 Markdown 形式にしているけど、実際はGoogle ドキュメントのスタイルで)。

通算回数は「結構話し合っている!」感が出てくるので分かる人は書いておくようにしている。ミーティングの最初に「うまくいっていることを全員が話す」ことでイケル感じのムードをつくると良いというのは「すごい会議」で学んだ。

 # 2019年05月30日(木) (第n回)

 ## うまくいっていること
 - (相手の名前):
     - 前回: (前回のうまくいっていることを転記)
     - 今回:
 - (自分の名前):
     - 前回: (前回のうまくいっていることを転記)
     - 今回:

 ##  話したいこと・気になること

 ### (相手の名前)より

 ### (自分の名前)より

自分の方が話しすぎちゃっているかもという反省から「話したいこと・気になること」から人別のセクション消して自分の方の議題をあらかじめ書かない方がいいんじゃないかとちょっと思って今週ちょっと消してみたりした。

でも Google re:Work - ガイド: マネージャーにコーチングを指導するのサンプルテンプレートでもマネージャーとチームメンバーのセクションがあって、やっぱり問題ないかなって思えてきたので今まで通りにすることにした。ってことがあったので書いてみた感じ。

身近な人がやっている形式の記事

[ 5月30日全て ]

2019年6月6日 (木)

表やダイアグラムの編集・表示に便利な Markdown エディタ Typora

image:/nDiki/2019/06/06/normal.png

表やダイアグラムを含むノートを編集・表示するのに Markdown エディタ Typora がかなり良さそう。

Markdown 形式をメインとしてテキストファイルベースでノートを書いていて不便だと思っているのが作表。Markdown ソースファイルで表を編集していて列の追加・削除・入れ替えが必要になった時にはエディタの支援が無いと絶望する。Markdown Mode for Emacs で表編集の機能がいろいろあることを知ってちょっといいかもと思ったけれども、やはり表としてレンダリングされた状態で編集したいなと。

そう思って探してみたら編集画面とプレビュー画面が別れていない Markdown エディタ Typora が表編集もサポートしていると知って試してみた。

使ってみたところ Google ドキュメントで表を編集しているようなのと同様な感じで直感的に表編集できた。欲しかったのこんな感じ!

image:/nDiki/2019/06/06/table.png

また表だけでなく

  • js-sequence
  • flowchart.js
  • mermaid

を使ってテキストで簡単な図を書けるというのも嬉しい。 Markdown ファイル中にテキストして書いておけるので、図の画像やそのソースファイルの管理に悩まされないで済むのだ。ノートにちょっとしたロジックツリーを書いておきたいことがあるので良い!

https://typora.io/

Markdown 文法GitHub Flavored Markdown ということだしこれは自分にとって主力 Markdown エディタになるのではという予感がする。

画像は Typora の PressKit https://typora.io/presskit.zip より。

[ ノート・日記はテキストファイルに ] [ Mac アプリケーション ]

[ 6月6日全て ]

2019年6月19日 (水)

mermaid の CLImacOS 上で使えるようにする

6月上旬に使い始めた Markdown エディタ Typora で mermaid を使いダイアグラムを作成してみたらなかなか良かったので、 mermaid のデータから画像を単独で生成できるよう CLI を入れた。

インストールは以下。

 $ brew install yarn
 $ yarn add mermaid.cli

実行は以下のような感じ。

 ~/node_modules/.bin/mmdc -b transparent -w 1920 -i input.mmd -o output.png
[ 6月19日全て ]

2019年6月25日 (火)

HTML ページ中の mermaid 定義を自動的にクライアント側で SVG 変換し表示させる

6月上旬に使い始めMarkdown エディタ Typora で mermaid を使いダイアグラムを作成してみたらなかなか良かったので、先日 mermaid のデータから画像を単独で生成できるよう CLI を入れてみた。しかしやはり都度画像ファイルに変換して管理するのは面倒。ちょっとしたノートを置いておくスペース nNote では事前に画像ファイルに変換しないで直接ページ上に書かれた mermaid ダイアグラムを SVG 変換して表示されるように設定してみた。

mermaid.min.js を Web サーバに配置し、ページの下部に以下が含まれるようにフッタファイルを編集。

 <script src="/path/to/mermaid.min.js"></script>
 <script>mermaid.initialize({startOnLoad:true});</script>

これでページ中に

 <div class="mermaid">
 graph LR
     a --- b
     a --- c	
 </div>

のようにダイアグラムの定義をmermaid クラスの要素の中に書いておくと、ダイアグラムの SVG 要素が生成し置き換えてくれる。表示は以下のような感じ。

graph LR a --- b a --- c

画像ファイルの管理から解放されるのでいろいろ捗って嬉しい。

とりあえず nNote 全フッタで mermaid.min.js を読み込むようにしちゃったけれど 8.0.0 ので 1.11MB ありダイアグラムの無いページで読み込ませるのはちょっと忍びない。 mermaid ダイアグラムの定義がある時だけ読み込むようにした方が良いね。

[ 6月25日全て ]

2019年7月11日 (木)

VS Code 入れたり Twitter のリストを整理したり【日記】

Markdown + mermaid.js / Viz.js を使ってみて、 PlantUML も使えるとやっぱりいいなあと思いまず Visual Studio Code (VS Code)を入れてみた。Atom っぽいな……なと思ったら両方とも Electron フレームワークを使っているのね。

それから、最近また Twitter みている時間がジワジワ増えてきたなぁと感じてきた。リストを整理して TweetDeck や twitcle で表示しておくリストを減らしてみた。バランス。

[ 7月11日全て ]

2019年9月12日 (木)

Google ドライブでのテキストファイル環境が大幅改善

拡張子 md のテキストファイルが全文検索対象に

Google ドライブ拡張子 md のテキストファイル(Markdown ファイル)が全文検索対象になってる! 以前は駄目だったので Google ドライブに置く Markdown ファイルは泣く泣く拡張子を txt にしていたんだけれどその必要が無くなったよ。

Android アプリ日本語テキストファイルを折り返して表示できるように

それから Google ドライブAndroid アプリ日本語テキストファイルをきちんと折り返してプレビューできるようになった。これで外出先でノートテキストファイル検索してさっと中身を確認できるようになった。感涙。

必要があればそこから Jota+ (テキストエディタ)に渡して編集し Google ドライブ上のファイルに反映もできる。

ついに全てのノートテキストファイルを外出先できちんと全文検索・閲覧・編集できる環境が手に入った!

[ ノート・日記はテキストファイルに ]

[ 9月12日全て ]

2019年10月2日 (水)

Ulysses 18 for Macプレーンテキストファイル編集ができなくなった

外部フォルダで、シートを「Ulysses ファイル」形式(拡張子 ulyz)での保存・管理を選べるようになった。Ulysses ファイルとして扱う設定にした外部フォルダではイメージ添付などができるようになった。

しかし Ulysses ファイルはバイナリファイルで他のテキストエディタを併用できない。自分のノート管理方針上使えない。

一方今回のアップデートでフォーマット無しのテキスト(プレーンテキスト)として表示・編集する機能が無くなってしまった(拡張子 txt のファイルも Markdown 形式として扱われてしまう)。これはかなり辛い仕様変更である。

Ulysses はすぐに \ でエスケープしてくるので気をつけないとすぐ \ だらけになってしまうんだよね。困った。

[ ノート・日記はテキストファイルに ]

今日のさえずり: Twitter 不具合について Twitter検索している。ん?

2019年10月02日

[ 10月2日全て ]

2019年11月9日 (土)

メインのライティングアプリUlysses から iA Writer

Ulysses 18 for Mac からフォーマット無しのテキスト(プレーンテキスト)として表示・編集する機能が無くなったのかなり不便である。ライティングアプリ iA Writer for Mac メインに変えようかなと。

iA Writer も全て Markdown 扱いになるのだけれど、 Ulysses のように勝手に \ でエスケープされて書き換えられるといったようなことがないのでそれほど困らない。

Ulysses ではパフォーマンスの問題で nDiki の全記事の入ったフォルダをライブラリ(外部フォルダ)に追加できなかったのだけれど、 iA Writer で試しにライブラリ(ロケーション)に追加したら意外や意外、問題無く操作できた。これは嬉しいぞ。

[ ノート・日記はテキストファイルに ]

[ 11月9日全て ]

2019年11月15日 (金)

Google ドライブではテキストファイル作成時の拡張子で全文検索対象になるか決まるみたい

Google ドライブにあるノートテキストファイルを参照したくなり、そこに必ず書かれていると分かっている単語で検索してみたけれど検索結果に出てこず「あれっ?」となった。検索結果に出るテキストファイルと出てこないテキストファイルがある。

全文検索対象になっていないテキストファイル

違いを調べたところ WebGoogle ドライブテキストファイルの詳細を右側に表示した際に「縮小されたサムネイル」が表示されるものは全文検索対象になっていて、表示されないものは全文検索対象になっていないようだ。

テキストファイルで「縮小されたサムネイル」が表示されるかどうかの違いだけれど、どうやら作成時(ローカルホスト上でファイルを作成して「バックアップと同期」で Google ドライブに最初にアップロードされる時を含む)に、拡張子が txt か md (Markdown ファイル)かで決まっているような挙動だった。最初に txt で作った後に md に変更しても全文検索対象だし、逆に最初に md で作ったファイルは後で txt に変更しても全文検索対象にならない。

Google ドライブに置くすべてのノートテキストファイル拡張子 txt で新規作成扱いにする

Google ドライブ拡張子 md のテキストファイル(Markdown ファイル)が全文検索対象になっていることに9月に気が付いてGoogle ドライブに置く Markdown ファイルの拡張子を md に統一したのだけれど、その結果「もともと txt だったものを md にリネームしたもの」「もともと md だったものを過去に txt にして再度 md にリネーム」「md で新規作成してずっとそのままなもの」が混在していて、全文検索されるかどうかがもはやよくわからない状態になっているのが自分の現状っぽい。

単純に拡張子を変更するだけでは駄目なことがわかったので、いったん Google ドライブの同期対象フォルダから18,000以上あるノートテキストファイルを外に出して、拡張子を txt に統一し、あらためて Google ドライブの同期対象フォルダに戻して新規作成扱いにした。これで全部検索対象になった模様。

Google ドライブに置く予定がない Markdown ファイルもデフォルトで拡張子 txt で作るよう各種設定を変更し、Google ドライブに置いていない既存の Markdown なノートテキストファイルもだいたい txt に変更しておいた。あとで「Google ドライブに置いておこう → (Google ドライブに同期したあとに)拡張子 md だったから txt にしておこう」とした時に、人知れず検索対象からハズレているという事態を避けたいので。

Google ドライブは全文検索ができるのが便利だけれど、 Dropbox みたいにローカルファイルシステムとの同期を前提とした設計で出発していないのか特殊な仕様が多いので、時々ハマるんだよね。

[ ノート・日記はテキストファイルに ]

[ 11月15日全て ]

About Me

Naney Naney (なにい)です。株式会社ミクシィで SNS 事業の部長をしています。

nDiki1999年1月に始めたコンピュータ日誌を前身とする NaneyWeb 日記(兼パーソナルナレッジベース)です。ちょっとしたノートは nNote にあります。

※内容は個人的見解であり所属組織とは関係ありません。

月別インデックス
Process Time: 0.100547s / load averages: 0.64, 0.71, 0.77
nDiki by WATANABE Yoshimasa (Naney)
Powered by DiKicker