Markdownでシーケンス図とかが書けるMermaid記法で業務フローを書いたら意外とイケたので自分なりのコツを紹介してみる | DevelopersIO
こんにちは、臼田です。 みなさん、業務設計してますか？(挨拶 今回はMarkdownでシーケンス図やフローチャートなどの図を記述できるMermaidを使って業務フローを書いてみたら、意外と書けたので自分なりのTipsを紹介したいと思います。 その前に 注意点として、まだMermaidを使い始めたばかりなので、「もっとこうしたらいいぞ」とか「こっちのほうがいいぞ」とかあれば建設的なフィードバックとしてSNSとかでいただけるとありがたいです。 あと業務フローって表現しましたが、人によって思い描く業務フローが違うと思うので、業務フローの定義に関するツッコミはご容赦ください。私が今回Mermaidで書いたのは以下の図です。(内容はブログ用に簡素化しました) この図のコードは以下のとおりです。(後ほど解説します) sequenceDiagram autonumber actor お客様 partic
ExcelやGoogleスプレッドシートをMarkdown出力するVS Codeの拡張機能「Excel to Markdown table」が便利すぎる件 | DevelopersIO
Markdownでテーブルを表現するにはつらみが深すぎる みなさんはMarkdownでテーブルを書くことは得意ですか? 私は苦手です。 簡単なテーブルは簡単に書けるのですが、以下のようなテーブルを書くことには抵抗感があります。 行数、列数が多い セル内に書くテキスト量が多い セル内でリストを表現する 一方、私は先日、「Markdownで手順を書いています!」とこちらの記事で伝えました。 そんな私に対して、 「オイオイオイ。 Markdownでもなんでもいいけどよォ... テーブルを使いたい場面は多いんだぜ。」 というセリフが聞こえてくる気がします。 私のようなMarkdownでテーブルを書くことにつらみを覚える方への解決策として、以下記事で紹介している「MarkdownTableMaker」があります。 このアドオンを使うことで、選択したスプレッドシートをMarkdownに出力してくれます
ARCHITECTURE.mdというものを書いてみた - maru source
こんにちは丸山@h13i32maruです。システム全体を簡単な図とテキストでまとめる「ARCHITECTURE.md」というものを最近知りました。これは良さそうと思い、JasperのARCHITECTURE.mdを書いてみました。 jasperapp/jasper/ARCHITECTURE.md ARCHITECTURE.md自体の目的は「プロジェクトへの新規参加者が全体像の把握を効率的に行えるようにする」という感じです。書き方の指針や注意点などは考案者による記事を見てもらうのがよさそうです。また良いサンプルとしてrust-analyzerというOSSのARCHITECTURE.mdが紹介されています。 https://matklad.github.io//2021/02/06/ARCHITECTURE.md.html https://github.com/rust-analyzer/ru
マークダウンでチャットボットをサクッと書けるサービスを作ってみた話 - Qiita
はじめに こんにちは、maKunugiです。 先日、マークダウンを書いて「ドキュメントを書くような感覚」でチャットボットを手軽に作成できる、「mabo」というサービスを開発し、ベータ版を公開しました。ぜひ経緯や内容を共有したいと思い記事を書いてみましたので、チャットボットに興味のある方はぜひ読んでみていただけると嬉しいです！ どんなものを作ったか サービスページ 利用ガイド maboはマークダウンをツラツラと記述するだけで、ブラウザ上で応答可能なチャットボットを簡単に構築できるサービスです。(スマホ・PC両対応) まるでドキュメントを書いているかのような感覚でチャットボットを手軽に構築できるのが特徴です。 チャットボットは公開URLを配布することで、様々なユーザに利用をしてもらうことができます。 （Slack上でも動作します。) なぜ作ったか 数年前にチャットボットブームが到来し、チャット
無料のMarkdown対応テキストエディタ「novelWriter」使用レビュー
PCで小説や長い文章を書いたことがある人の中には、シーンとシーンの場面転換がゴチャゴチャになってしまったり、登場人物や場面が多すぎて収拾がつかなくなってしまったりといった経験がある人もいるはず。無料で使用できるオープンソースのテキストエディタ「novelWriter」は、Windowsのエクスプローラーのようなツリー形式でチャプターやシーンを構成することが可能で、Markdown記法で見やすく表示することも可能とのことなので、実際に使ってみました。 novelWriter – A markdown-like editor for writing novels https://novelwriter.io/ ◆インストール 上記のURLにアクセスするとこんな感じ。novelWriterはソフトウェア開発プラットフォームのGitHubで公開されているので、赤枠で囲われた「GitHub」をクリッ
novelWriter
A markdown-like editor for novels A markdown-like text editor designed for writing novels and larger projects of many smaller plain text documents. It is designed to be a simple text editor that allows for easy organisation of text files and notes, with a meta data syntax for comments, synopsis, and cross-referencing between files, and built on plain text files for robustness.
Markdown で技術書が書ける｜abechanta
ソフトウェアに関する記事やコラムを書くなら、Markdown 記法はとても良い選択です。見た目の統一感があり、覚えやすく、軽量です。 この「Markdown での書きやすさ」を物理書籍や電子書籍の執筆にも応用できたらな、、、 "W3C Paged Media Viewer" はそれを実現する、OSS の Visual Studio Code のエクステンションです。エクステンションを入れただけの超シンプルな環境を使って、手間いらずでサクッと技術書を執筆することができます。 以下に示すとおり導入は簡単です。 1. VS Code を起動します 2. CTRL + SHIFT + X とタイプして Extensions ビューを表⽰します 3. 検索ボックスに paged media と⼊⼒し、 W3C Paged Media Viewer あるいは abechanta.vscode-ext-
マークダウンファイルから日本語音声付き動画を作成できる「Video Puppet」を使ってみた！ - paiza times
どうも、まさとらん（@0310lan）です！ 今回は、単純なマークダウンファイルから動画を生成してダウンロードできるWebサービスをご紹介します！ ブログ記事を書くようにテキストデータを動画に変換できるうえ、自然な日本語音声も自動生成してくれます。また、画像や音楽などのメディアも挿入できるので、チュートリアル動画やPR動画などさまざまな作品を作ることができます。 現在はベータ版で全機能を無料で使えるため、動画作成にご興味がある方はぜひ参考にしてみてください。 【 Video Puppet 】 ■「Video Puppet」の使い方 それでは、最初に「Video Puppet」をどのように使うのか詳しく見ていきましょう！ トップページにアクセスしたら、画面上部にある【SIGN UP】ボタンから無料のユーザー登録をしておきます。 （※登録しなくても制限付きで利用することは可能です） ユーザー名
【VS Code + Marp】Markdownから爆速・自由自在なデザインで、プレゼンスライドを作る - Qiita
【VS Code + Marp】Markdownから爆速・自由自在なデザインで、プレゼンスライドを作るMarkdownVisualStudioCodeDraw.ioMarpvega TL;DR Visual Studio Code上で、Markdownから、こんな感じのデッキを生成できるようにします。 使用したファイル類は、GitHub tomo-makes/marp-styles にまとめました。 きっかけ 叩き台となる資料がなく、急ぎプレゼンをする機会があり、Marpで作成した 内輪では使っていたが、多くの目に触れるのは初めてで、もう少しデザインを調整したいと思った 今後も使いまわせるものを、スニペット、およびサンプルテーマ化しておこうと思い立った ついでにいろいろな図表の生成とデッキへの入れ方、必要そうな配色、素材のリンクをまとめておきたい Marpとは Marp: Markdown
記事の書き方
writing.md 記事の書き方 記事の執筆には、Markdown形式を利用してください。 Markdownにはさまざまな流派がありますが、GitHub Flavored Markdown（https://github.github.com/gfm/ ）をベースとした書式を採用します。 書籍を執筆するための形式として考えると、Markdownには不足している機能が多々あります。 しかし、次のような利点があるので、Markdownを採用することにします。 最低限の構造しかないので、見た目でごまかせる余地が少ない 原稿を著者自身が再利用してもらいやすくしたい ラムダノートで販売する際のスタイルは、原稿の形式がなんであれ、別に考えなければならない 以下では、節や項といった記事の大構造、および、段落やコードや図表といった記事の小構造について、 執筆にあたって気を付けていただきたいことや記述方法の
MarkdownをPDFに変換する「md-to-pdf」は痒いところに手が届く素敵ツール | DevelopersIO
Markdown to PDF Markdownで書きたいけど、PDFで出力したい という機会はエンジニアはよく出くわすと思います。 「Markdown to PDF」といえばGitBook CLIが有名ですが、こちらはメンテナンスがストップされているため推奨されません（環境依存による不具合などが解決されない）。 GitBookほど多機能でなくても良いですが、綺麗にいい感じに出力したい…！と探し回っていたところ md-to-pdf が最も私の要件に合致したので使ってみました。 そんな私の要件はこちら。 CLIから出力したい ページ内リンクが作れる ページ分割ができる ページ数表示が簡単にできる 全体に対して簡単にテーマをCSSで適用できる いざという時にはHTML+CSSでカスタマイズができる それに対して md-to-pdf は以下のような機能があります。 ディレクトリ内のMarkdow
Wordを捨て、テキストファイルで書こう!? IT業界の人が利用する「マークダウン」という不思議な形式 « ハーバー・ビジネス・オンライン
「マークダウン」（Markdown）という言葉を聞いたことがあるだろうか。Web系を中心としたプログラマならよく馴染んでいる言葉だ。 マークダウンはテキストファイルの書き方のひとつだ。特別なファイル形式ではない。見出しや強調したい部分、リンクや画像の挿入について一定のルールで書く。それ以外は、普通のテキストファイルと変わらない。 そうして書いたテキストの文書を、特定のWebサイトに投稿すると、見栄えよくHTMLに変換してくれる。手元でHTMLファイルに変換したければ、マークダウンエディタと呼ばれる種類のテキストエディタを使えばよい。エディタの一機能として、マークダウン変換機能が付いていることもある。 文書の整形に「Word」を立ち上げる必要はない。「Word」の不可思議な挙動に悩まされることもない。使い慣れたテキストエディタで、サクッと書けばよい。シンプルなテキストで、小さなファイルサイズ
Markdown の見出しに章番号を振る方法(ついでに目次にも) - Qiita
はじめに Markdown でちょっとしたメモを書いていると、メモ書きのつもりが、それなりの規模になってきて、目次を作りたくなる。目次をつけるのは Markdown Preview Enhanced の機能でできる。 そんで、目次をつけると、どうも章番号を振りたくなってくる。 章番号を振る一番単純なやり方は、見出しに対して手でぽちぽち番号を振っていく方法だけれども、文章の更新がかかるたびに番号を振りなおすのはいかにも効率が悪い。 というわけで Markdown Preview Enhanced のスタイルを使って、見出しに対して自動的に章番号を割り付けるようにしたので、その方法をまとめておく( Markdown Preview Enhanced とは書いているけど、同様に CSS で見た目をコントロールしているよう他のプレビュー機能でも有効な方法のはず)。 ついでに、同様の方法で目次にも番
Classicc - 整理しなくてもうまくいくノート
# こんな感じで横に並べてメモが書けます。紙のノートのように新しいメモを右にどんどん追加していくことができます。横に並べると、 前のメモが読みやすいメモからメモの移動が簡単前のメモを見ながらメモができる1画面に表示するメモの種類が多くなりすぎないという良さがあり、ノートを書くのが快適になります。実際に右のメモをちょっとだけ見てみましょう！リンクを開くより簡単ですよね！？このメモに戻ってくるのもすごく簡単！これが横並びの良さです！ # 整理はやめたClassiccは、書き始めるまでに考えないといけないことを極力排除しています。 メモをするときに、 あらかじめ決めたルールを思い出しメモを残すためのノートを開きあとで見つけやすくするためのタグをつけてメモをするってやるのめんどくさいですよね？ Classiccではめんどくさいステップは排除して紙のノートと同じステップ、「ノートを開いてメモを書く」
技術書典6に向けて、技術系同人誌の執筆・制作環境についてまとめてみる - このすみノート
私は技術書典4・5と、個人でサークル参加をしてきたサークル主です。本の制作環境を迷いながら選択することが多かったので、技術書典6にサークル参加される方への備忘録も兼ねて、まとめてみました。 まずは技術同人誌を執筆するための制作環境ですが、私が観測した範囲内では、以下のいずれかでした。 Microsoft Word / Googleドキュメント Markdown LaTeX InDesign / CLIP STUDIO Re:VIEW単体 Re:VIEW + (InDesign / CSS組版)などの組み合わせ VivliostyleでCSS組版 それぞれ簡単ではありますが、所感をつらつらと綴ってみます。なお、眠くて概要を説明する気力がなかったため「◯◯とは？」的な内容は、それぞれのワードで検索して補っていただけると幸いです。 Microsoft Word / Googleドキュメント Wo
「技術同人誌をMarkdownで書く」とは、実際どういうことか？｜藤原 惟
※ この記事はすべて無料でお読みいただけます。投げ銭歓迎。 ※ またこの記事は「技術同人誌 Advent Calendar 2018」の4日目です。 ※ 12/4 22:34 追記・微修正 以下、技術同人誌を書きたい方・既に書いている方に向けて書いていきます。（Markdown一般の話に比べると、やや高度なことを説明しようとしています。あらかじめご了承ください） ---------------- 技術同人誌という存在を知り、自分でも書きたくなったITエンジニア（特にWeb系）にとって、 「技術同人誌を書くなら、Markdownで書きたい！」 という魂の叫びは当然のことでしょう。 Markdownを使ってブログを書き、簡単な図ならmermeidやPlantUMLで直書きし、プレゼン資料まで作ってしまうMarkdownフリークであれば、「技術同人誌ぐらい、Markdownで書けるはずだ！」とい
Wordな職場にMarkdownを定着させるためにやった４つのこと - Qiita
はじめに ドキュメントって皆さんどうしていますか？ Qiitaで記事を書いている方なら、Markdownを普段から使う人も多いと思います。 私の職場では、「Wordでドキュメントを書く」という習慣がありました。 最近、「Markdownで書く」というのを定着させることができましたので、その過程で何をやったのかを共有したいと思います。 2018/11/02 追記 本記事に、Microsoft Wordを批判する意図はございません。 WordよりもMarkdownが優れているという主張をするつもりもございません。 それと、後出しで恐縮ですが、本記事に登場する職場とは、ソフトウェアエンジニアがメインの部署です。 ドキュメントというのも、技術系資料です。 その前提でお読みください。 誤解があるといけないので追記いたしました。 （追記終わり） やったこと１：議事録をMarkdownで取った 私の職場
大量のテキストを食っても速い Markdown Editor 作った - mizchi's blog
もう人生で何個目かわからない markdown エディタ作った。が、今回のは結構気に入っている。 https://markdown-buffer.netlify.com/ で遊べる。 用途としては、GitHub か Qiita か はてなブログかわからないが、なにか書こうと思ったときに、どのサービスも中途半端に重いので、とりあえずのバッファが必要、という感じで作った。なので速度重視。 ブラウザのストレージで永続化してる。オフラインで動く。できるだけエディタとしてはスコープを大きくせず、単に編集バッファ(textarea)でしかない、というのを意識している。 結構頑張って作り込んでしまった https://nedi.app が色々肥大化してしまっていて入力時にラグを感じるので、編集体験を見つめ直す自戒もある。 機能 数式対応 コードハイライト対応 バックグラウンドで自動保存 改行を br に
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - KaiseiYokoyama/repub_cli: markdown docs to epub3
Markdownで書けるシンプルなナレッジベース構築の為のソフトウェア・「Raneto」 | かちびと.net
