Markdownというマークアップ言語がエンジニア界隈で広く使われている。もともとはHTMLをもっと簡単に記述したいという意図で開発されたものだそうで、<h1>タイトル</h1>と書くかわりに# タイトルと書けたりするので、記述が少し簡単になるというメリットがある。太字(<b>)やリスト(<ul><li>)なども簡単に書ける。 Markdownに慣れたエンジニアがよく「何故ScrapboxはMarkdownを採用しないんだ」と言ってくる。「Markdownを採用しないとか馬鹿じゃないの?」とまで言う人もいる。こういう人々は完全にMarkdown脳というか、自分がタマタマ慣れているものがサイコーだと考えているだけに思える。 ScrapboxのようなWikiで一番大事なのはページ間リンクの記述であり、ここに[...]という単純な記法を使っているためMarkdownとは異なる記法になっているのだ
なぜ Day One は Markdown を捨てたのか Day One が Markdown をやめて WYSIWYG に移行した話は前書いた。 Day One がクソになった Day One 、このブログでも度々言及していて、 Markdown で日記が書けて便利だったんだけど、最近のバージョンアップ( Mac は 2.8 以降 、 iOS は 3.0 以降)でプレー... portalshit.net 自分が知っている範囲でアンチ Markdown 勢は Scrapbox くらいしか思い浮かばず、 GitHub や Trello などのグローバル勢に加え、 Qiita やはてなブログなど日本国内向けのサービスでも当然のように Markdown が共通言語として使われているのに、その Markdown を捨てて WYSIWYG 化する1という戦略は疑問だった。 ひとむかし前の WYSI
データアナリティクス事業本部 サービスソリューション部 サービス開発チームのしんやです。 Notionの直近リリースノートに「Mermaidっていうマークダウン構文がNotionで使えるようになったよ!」という情報が載っていたので、試してみた内容を軽くではありますが紹介したいと思います。 目次 Mermaidとは 実践 #1. フローチャート #2. シーケンス図 #3. クラス図 #4. 状態遷移図 #5. ER図 #6. ジャーニーマップ #7. ガントチャート #8. パイチャート #9. 要件図 まとめ Mermaidとは Mermaidとは、フローチャート、シーケンス図、クラス図、ガントチャート、およびgitグラフを生成するためのマークダウン構文です。 コードから良い感じのグラフを生成できるイメージについては下記動画を参照頂くと良さそうです。 実践 では早速実践してみたいと思いま
手順書フォーマットは千差万別 みなさんは自己流または、組織やプロジェクトで定められた手順書のフォーマットはありますか? 私は自己流の手順書フォーマットがあります。 自己流の手順書フォーマットがあるといっても、かなり扱いがふわふわしているので、備忘やメモの意味合い強めでまとめていきます。 「もっとこうした方がいいよ!!」などフィードバックがあれば、ぜひお願いします! いきなりまとめ 手順書はExcelやスプレッドシートではなく、Markdownで書く 手順書はgitで管理する 5W1Hを意識して手順書を書く 基本的にはCLIを使った手順書にする 手順書はExcelやスプレッドシートではなく、Markdownで書く 手順書をExcelやスプレッドシートで書くメリット・デメリット 手順書をExcelやスプレッドシートで書いている方も多いと思いますが、私はMarkdownで書いています。 Exce
Marp というツールで Markdown から手軽にスライドを作る方法と、そのスライドを GitHub Pages で自動的に公開するためのツール Marp CLI Action というものを作ったので紹介します。 先に結論だけ述べますと、Marp のエコシステムを使ってスライドを書き、GitHub にプッシュすれば Marp CLI Action を含んだ GitHub Actions で GitHub Pages に自動でスライドを公開できます。 前置き 会社や勉強会でプレゼンをするとき、どのようにスライドを作成しているでしょうか? PowerPoint、Keynote、Google スライドなど、さまざまなやり方があると思います。 私はとにかく楽に作りたいので Marp というツールを使っています。 Marp とは Marp は Markdown 記法でプレゼンスライドを書けるツー
【VS Code + Marp】Markdownから爆速・自由自在なデザインで、プレゼンスライドを作るMarkdownVisualStudioCodeDraw.ioMarpvega TL;DR Visual Studio Code上で、Markdownから、こんな感じのデッキを生成できるようにします。 使用したファイル類は、GitHub tomo-makes/marp-styles にまとめました。 きっかけ 叩き台となる資料がなく、急ぎプレゼンをする機会があり、Marpで作成した 内輪では使っていたが、多くの目に触れるのは初めてで、もう少しデザインを調整したいと思った 今後も使いまわせるものを、スニペット、およびサンプルテーマ化しておこうと思い立った ついでにいろいろな図表の生成とデッキへの入れ方、必要そうな配色、素材のリンクをまとめておきたい Marpとは Marp: Markdown
のんびりしていたらこんなメンションをもらっていたので、ちょっとまとめてみようと思います。 そろそろ @tk0miya さんがアップしてくる頃。GFMはspecかっちりしてるんでしたっけ(markdown全く詳しくない — Aki Ariga (@chezou) February 1, 2020 かっちりしている? この記事を読んでいる皆さんは Markdown の歴史に精通していると思うので、古い部分はざっくり割愛してしまいますが、オリジナルの Markdown は かっちりしていない ことで有名なマークアップ言語です。 必要最低限のマークアップ要素は規定されていて HTML への変換ツールも完成していた Markdown ですが、マークアップ言語の言語仕様としては貧弱で、インデントのルールやインライン要素をネストしたときの挙動、空行の有無による解釈の違い、などなど、細かい部分のルールにつ
はじめに ドキュメントって皆さんどうしていますか? Qiitaで記事を書いている方なら、Markdownを普段から使う人も多いと思います。 私の職場では、「Wordでドキュメントを書く」という習慣がありました。 最近、「Markdownで書く」というのを定着させることができましたので、その過程で何をやったのかを共有したいと思います。 2018/11/02 追記 本記事に、Microsoft Wordを批判する意図はございません。 WordよりもMarkdownが優れているという主張をするつもりもございません。 それと、後出しで恐縮ですが、本記事に登場する職場とは、ソフトウェアエンジニアがメインの部署です。 ドキュメントというのも、技術系資料です。 その前提でお読みください。 誤解があるといけないので追記いたしました。 (追記終わり) やったこと1:議事録をMarkdownで取った 私の職場
Vue.js 日本ユーザーグループ では Vue Fes Japan 2019 に向けて、月イチくらいのペースで定例 MTG を開いているんだけど、その議事録を HackMD という共同編集可能な Markdown エディタ(Web サービス)を使うようになってだいぶ捗ったので共有。 解決したかった問題 HackMD を導入する以前は、 Slack のスレッドをつくって、そこに有志が書き込んでいく MTG が終わったら、誰かが議事録として esa に書き起こす というのをやっていた。そうすると、 話が行ったり来たりすると Slack スレッドがカオスになって分かりにくくなる 議事録としてまとめる作業が面倒 という問題を抱えていた。 HackMD で議事録 まず、あらかじめ MTG で話したいことをアジェンダでまとめておく Vue.js 日本ユーザーグループでは、ドキュメントの管理に esa
1年間 書きかけで放って 温めていたネタ😅 最近 VSCode+Markdownでプレゼン資料を作ったのでメモ。 Markdownいいよ、いいよ~ という話は前々からしていたけどMarkdownに慣れてしまうと、なんでもMarkdownにしたくなってくる(笑 もちろん得手不得手あるのでやり過ぎも良くはないことは重々承知。 自己満足だけどちょっとした資料であればさっとMarkdownで書けるに越したことはない。 使い捨てプレゼン ところで、社会人になって15年。 数多のプレゼン資料が爆誕しては消えていくという現象を見続けてきた。 プレゼン資料は発表の為に作られた資料だから、終われば不要になるのは当然。 けれど慣れないプレゼンソフト使ってなんとか作ったものを捨てるのは忍びないものだ。 たまに たまにチーム内でちょっとしたプレゼン(説明会)を行うことがある。 プロジェクターで伝えたいポイントが
※ この記事はすべて無料でお読みいただけます。投げ銭歓迎。 ※ またこの記事は「技術同人誌 Advent Calendar 2018」の4日目です。 ※ 12/4 22:34 追記・微修正 以下、技術同人誌を書きたい方・既に書いている方に向けて書いていきます。(Markdown一般の話に比べると、やや高度なことを説明しようとしています。あらかじめご了承ください) ---------------- 技術同人誌という存在を知り、自分でも書きたくなったITエンジニア(特にWeb系)にとって、 「技術同人誌を書くなら、Markdownで書きたい!」 という魂の叫びは当然のことでしょう。 Markdownを使ってブログを書き、簡単な図ならmermeidやPlantUMLで直書きし、プレゼン資料まで作ってしまうMarkdownフリークであれば、「技術同人誌ぐらい、Markdownで書けるはずだ!」とい
4月にInkdropの総売上が10万円を超えた報告をしてから、久々の売上報告です。Inkdropはクローズドソースですが、プロジェクトで得た知見は惜しみなくオープンにしていくつもりです。どんどんやり方パクってください。もし質問などあればコメント欄やTwitterにて受け付けます。 TL;DR驚きの解約率の低さ注文の多い少数派を相手にしすぎないブログを始めたら日本のユーザが増えた1000人のユーザが1人を食わせるモデルを確立したいInkdropはMarkdown好きのためのノートアプリ既にInkdropについてご存知の方は読み飛ばして下さい。 Inkdropはマルチプラットフォームで動作するノートアプリです。今のところmacOS、Windows、Ubuntu、iPhone、Androidに対応しています。 日々の作業記録や議事録、コードスニペットからブログの下書きまで、技術的な事柄を構文ハイ
Markdown でスライドを作るためのツールを漁っていたのですが、なかなか自分好みのものが無く、Electron の勉強を兼ねて作ってみた話です。 追記 (2018/12/10): その後の進捗はこちら Puppeteer & Carlo を Markdown スライド作成 CLI ツール (Marp CLI) で活用する - Qiita 成果物 今回作ったプレゼンツールは、以下にてプレリリース版を公開しています。 Marp - Markdown presentation writer https://yhatt.github.io/marp/ (旧称 mdSlide) 追記 (2016/07/13 19:42) _人人人人人人人人人人人人人人_ > 突然のGithubトレンド入り <  ̄Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y^Y ̄ Markdown スライドツール比較表 私の欲
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く