gitbookで設計書を作成したら最高だった話 - フォトシンス エンジニアブログ
こんにちは。Akerunエンジニアの @ishturk です。 Akerun Advent Calendarの記事です。 今日は設計書の話です。 設計書をどんなツールで書くかは、僕らソフトウェアエンジニアの尽きない悩み（楽しみ）ですね。 最近はまったツールが最高に良かったので紹介させてください。 僕のツールに求める要件は以下です。 編集がカジュアルにできる UMLが書ける。あとから編集できる（画像での貼付けは編集できないのでNG） バージョンの管理ができる 好きになれる（重要） 変遷と pros/cons MS Word pros 良くも悪くもスタンダードなツールですね。 だれでも編集できるのが強みです。 Visioと組み合わせれば、UMLも後から編集可能です cons Visioは標準にするには少々値が張ります。 バイナリ形式なのでバージョン管理はしづらいです。 ページが増えたり画像を貼
【導入3分】GoogleスプレッドシートをMarkdown出力するアドオン「MarkdownTableMaker」が超絶便利で悶絶 | DevelopersIO
「もっと早く知っておけばよかった・・・」 という気持ちしか湧いてこない、素晴らしいGoogleスプレッドシートのアドオンがあったので紹介します。昔から探してたんですが、ようやく巡り会えました。 導入も利用方法も超カンタン、普段からMarkdownで表を書いている人には絶対オススメしたいアドオンなので、これを機にガンガンMarkdownで表を書きましょう！ 2021年1月25日追記 現在、このアドオンが利用できなくなっています。ちょっと探しましたが代替のサービスもなさそうで、似たようなサイトとしてこちらが使いやすいかと思います。 Create LaTeX tables online – TablesGenerator.com 「MarkdownTableMaker」とは？ Googleスプレッドシートの内容を、Markdown記法で出力するアドオンです。Markdownはドキュメント記述に非
Markdownエディタを作って月15万円稼ぐためにやったこと — Inkdrop
自分でもびっくりしてるいぬさん僕はフリーランスをしながら脱受託を目指してアプリを作って生活しています。だいたい1年のうち7割ぐらいをアプリ作りの時間に充てています。本稿では、Inkdropというマルチプラットフォーム対応のMarkdownエディタを一人で開発して月15万円の売上を達成するまでにやった事を包み隠さずにシェアしたいと思います。 Inkdropの月間売上の推移やったこと概要毎日感じるちょっとした問題を見つける自分自身がこれだ！と思えるまでプロトタイプを作るプライベートβ期間でヘビーユーザを作る継続性を重視して価格をつける決済処理はStripeで楽に実装する良いランディングページを作るユーザサポートを最優先にする自分の得た知見を惜しまずブログに書くクオリティで勝負する批判を全て無視する毎日感じるちょっとした問題を見つける僕は別に特別でもなんでもありません。人は意外と同じ事を感じたり
技術ドキュメンテーションのためのreStructuredTextとMarkdownを比較する | POSTD
Markdown と reStructuredText はどちらもマークアップ言語で、どのテキストエディタを使っても簡単に入力できるように設計されたプレーンテキスト形式構文です。どちらにもマークアップされたテキストをHTMLやPDFなどの出版形式に変換できるツールが多数あります。 これらのマークアップ言語は多くのドキュメンテーションシステムの基礎となるため、昨今のソフトウェア開発者はマークアップ言語をよく知っておく必要があります。この記事ではプログラマ視点でMarkdownとreStructuredTextのトレードオフを分析します。 Markdownが輝きを放つ場所 テキスト入力による豊富な書式設定で複雑なドキュメント構造を記述することができるマークアップ言語は長く輝かしい歴史を持っており、その歴史は少なくとも1970年代初めの troff とTeXまで遡ることができます。 これらの形式
MarkdownノートアプリInkdropで家賃の半分が賄えるようになりました
4月にInkdropの総売上が10万円を超えた報告をしてから、久々の売上報告です。Inkdropはクローズドソースですが、プロジェクトで得た知見は惜しみなくオープンにしていくつもりです。どんどんやり方パクってください。もし質問などあればコメント欄やTwitterにて受け付けます。 TL;DR驚きの解約率の低さ注文の多い少数派を相手にしすぎないブログを始めたら日本のユーザが増えた1000人のユーザが１人を食わせるモデルを確立したいInkdropはMarkdown好きのためのノートアプリ既にInkdropについてご存知の方は読み飛ばして下さい。 Inkdropはマルチプラットフォームで動作するノートアプリです。今のところmacOS、Windows、Ubuntu、iPhone、Androidに対応しています。 日々の作業記録や議事録、コードスニペットからブログの下書きまで、技術的な事柄を構文ハイ
GitHubだけで超高機能なスライド資料が作れる「GitPitch」の使い方を徹底解説！ - paiza times
どうも、まさとらん（@0310lan）です！ 今回は、ブラウザ上のGitHubでMarkdown（マークダウン）ファイルを作成し、そのまま超高機能なスライド資料に変換してくれるサービスのご紹介です！ もちろん、自分でMarkdownファイルを用意してpushするだけでもOKなのですが、今回はコンソール画面などは使わずにすべてブラウザだけで完結できる方法をご紹介致します。 【 GitPitch 】 ■「GitPitch」の基本的な使い方！ それでは、実際に簡単なスライド資料を作ってみましょう！ まず最初に、自分のGitHubアカウントでログインし、新規のリポジトリを作成しましょう！ 「① リポジトリ名」は好きな名前を付けてください。 画面下にある「② チェックボックス」をONにしてから「③ Create repository」ボタンをクリックしましょう。 すると、自動的に「README.md
Markdownで書く電子書籍開発環境
Markdownで書く電子書籍開発環境 #niku_sushi 自己紹介 Name : azu Twitter : @azu_re Website: Web scratch, JSer.info JavaScript Plugin Architecture JavaScript Plugin Architecture 電子書籍の開発中にやったこと やりたかったこと [Markdown] 電子書籍開発環境 · Issue #42 Markdown/文章のLint インラインコードのLint ファイルのincludeするMarkdown拡張 Markdown to HTML or PDF エディタ [Markdown] 電子書籍開発環境 · Issue #42 Markdown/文章のLint => textlint インラインコードのLint => ESLint ファイルのincludeする
mermaid.jsが素晴らしいけどなかなか使ってる人見かけないので実例晒す(追記あり) - Qiita
mermaid.jsとは JavaScriptのチャート作成ライブラリです。他にも似たようなのは色々ありますが、これ一本でフローチャート、シーケンス、ガントに対応してるので、個人的にお気に入り。 http://knsv.github.io/mermaid/ サイトの各チャートのページ見ると書き方と何ができるかはわかるので、ご覧あれ。 僕の使い方 JSのライブラリを自分でインポートして何かすることはほとんど無くて(後述の理由からガントだけJSで使ってるけど)、基本的には以下の2つの方法で使ってる。 Haroopad フリーでクロスプラットフォーム(OS X, Win, Linux)なMarkdownエディタ。 v0.13からmermaid.jsがインテグされているので、何もしなくてもそのまま使える。 mermaid.jsのグラフの書き方は、コード表記で、言語をmermaidにしてあげるだけ。
Windows, Mac, Linuxで使えるMarkdownエディタ、HarooPadを使う - Qiita
2015/05/12追記 : Kobito for Windowsが出ました。 Windowsでも使えるMarkdownエディタ KobitoとかMouとかいい感じのMarkdownエディタはなぜかWindows対応してない！なので、WindowsユーザーでMarkdownを編集するのに良いエディタがなくて困っているという人は多いんじゃないでしょうか？ しかし先日、Moongiftで紹介されていたHaroopadというエディタがなかなかいい感じでした。 Haroopadとは Haroopadは、node-webkitというNode.js + WebKitのクロスプラットフォームなUIキットを使って作られたMarkDownエディタです。 QiitaやGithubと同じように ```js console.log("hello"); ``` みたいに記述すれば、コードのシンタックスハイライトも使
GitHub - mermaid-js/mermaid: Generation of diagrams like flowcharts or sequence diagrams from text in a similar manner as markdown
Mermaid is a JavaScript-based diagramming and charting tool that uses Markdown-inspired text definitions and a renderer to create and modify complex diagrams. The main purpose of Mermaid is to help documentation catch up with development. Doc-Rot is a Catch-22 that Mermaid helps to solve. Diagramming and documentation costs precious developer time and gets outdated quickly. But not having diagrams
Github で Jekyll を使う時に調べたこと | そんなこと覚えてない
Github で Jekyll を使うときにできることとか調べたので整理しておきます。 今日の成果物。 この記事をいきなりポーンと書いても仕方ない気がして前の記事を書きました。 Github Pages について整理しておきます Jekyll を利用するかしないかの判断材料などに利用してください。 利用できる マークアップ HTML Markdown Textile 関連する gem liquid- テンプレートエンジン redcarpet - 高機能高速動作な Markdown maruku - 高機能な Markdown rdiscount - 高速動作な Markdown RedCloth - Textile Pygemnts.rb - シンタックスハイライト できること Layoutの利用 - ネスト可能 includeの利用 - Jekyll Boostrap がかなり利用してる
Markdown Edit·エクスポートにも対応したWebベースのMarkdownエディタ MOONGIFT
Markdownは通常、HTMLに変換するとあってWebベースのエディタと相性がいいように思います。また特に多く使うのがGitHubのREADMEであり、こちらもWebベースで表示されることもあるでしょう。 色々なMarkdownエディタが存在しますが、今回はMarkdown Editを紹介します。Webブラウザベースで使えるオンラインMarkdownエディタ、ビューワーです。 Markdown Editの使い方 こちらがエディター画面です。2ペイン構成になっています。 リアルタイムアップデート機能があります。 HTMLエクスポートした場合。 Markdown EditはJavaScriptのMarkdownレンダリングエンジンであるmarkedまたはGitHubのAPIを使ってレンダリングができます。またローカルファイルをドラッグ&ドロップでアップロードして編集もできるようになっています
Markdownでプレゼン用スライドをつくる方法いろいろ - その後のその後
明日は 「yidev第十五回勉強会」、来週はクックパッドさん主催の 「WWDC2014 振り返り勉強会」で発表をさせていただく *1 のですが、まずMarkdownで話そうと思うことを適当にメモしてるうちに、なんか発表資料このままで良くない？と思えてきました。別にレイアウトや配色のセンスに自信があるわけでもなし。 で、最初 "markdown pagination" でググってみるとあまりパッとしたのがなかったのですが、"markdown presentation" にしてみると出るわ出るわ。しかもどれも結構よさげ。 というわけで出てきたものをメモがてら書き留めておきます。結論からいうとググって一番上に出てきた "Remark" が今回の要件に（ほぼ）マッチしていたので、他はまだ使ってません。 Remark http://remarkjs.com/ GitHubでソース公開されてて気軽に使
プレゼンもmarkdownでね！reveal.jsで資料を作成してみた - Qiita
概要 社内のLTで、発表まで時間あるし パワポの資料作るの面倒だし っていうか、MacにしたからOfficeないし Google Appsでプレゼン資料作るのもいいけど なんか他の方法で準備したいなー showoff入れてみたけどreveal.jsのほうが見た目かっこよさそうだなー 的な話。 作った資料 github pagesにアップしました http://imura81gt.github.io/201405-LT/#/ ※元ネタはこちら：http://qiita.com/imura81gt/items/03e926d7e17352a3dcf4 参考URL Reveal.js、Markdown、Githubでスライドを作成する。 REVEAL.JSを使ってみた 公式 公式github : markdownについて 公式github : pdf出力について reveal.jsを入手 さくっ
Collaborative Markdown - コラボレーション機能付き。WebベースのMarkdownエディタ MOONGIFT
最近流行のMarkdownエディタ。ローカルアプリケーションあり、Web版ありと様々なエディタが存在します。個人で書く分には様々な選択肢から選べば良いですが、みんなで文書を一緒に編集するとなると選択肢は限られるでしょう。 そんな時に欲しいのはWebベースでコラボレーションできるソフトウェアではないでしょうか。リアルタイムなコラボレーションをサポートしたCollaborative Markdownを紹介します。 Collaborative Markdownの使い方 画面を見て分かる通り、2ペインに分かれた構成になっています。これは良くある形式ですね。 日本語も書けます。プレビューはリアルタイムに反映されます。 さらにコラボレート。左側に接続している人の一覧が出ます。 コラボレーション中のデータもリアルタイムに反映されますので、複数人で一気に文書を作り上げるのも簡単です。保存もその場で行われま
Rubyで使えるMarkdownパーサー - ひげろぐ
なぜだか知らないけどたくさんある。 Markup processors in The Ruby Toolbox RDiscountとBlueClothが定番で、Redcarpet（GitHub-Markupで内部的に使われているもの）が元気なニューフェイスといったところか。 違いは速度と拡張記法のサポート具合なのかな。 Markdownはシンプルだけどその分できることは限られているので独自拡張のニーズや実装がいくつもあるようだ。 拡張自体はどこかに仕様があるのか、それとも各ライブラリが勝手にやっているのかちょっと追いかけられていない。 気に入った拡張記法をサポートしているかどうかが選択のポイントか。 速度は速いに越したことはないが、個人ユースではそんなに気にする必要はないように思う。 BlueCloth BlueClothが古くからあるものなので、後発のものもBlueCloth互換のAPI
Markdownをプレゼンテーションに変換·pydown MOONGIFT
pydownはPython製のソフトウェア（ソースコードは公開されていますがライセンスは明記されていません）です。 Markdownの利用範囲が広がっています。単純なテキストに限らず、ブログのコンテンツに使ったり、Webサイト全体をMarkdownで作ってしまう試みもあります。今回はMarkdownをHTMLプレゼンテーションに転換するpydownを紹介します。 変換処理をした後はHTML/スタイルシート/JavaScriptファイルが生成されます。 キーボードでスライドを切り替えます。 コードハイライト対応。プログラマー向けですね。 一つ前のプレゼンテーションの内容を表示する機能もあります。 pydownの機能はシンプルですが、Markdownをベースに使えるので配布資料はテキストファイルで、Webブラウザではスライドとして閲覧できますと言ったやり方が出来ます。ブログで使うこともできそう
Reveal.jsとMarkdownでちょっとしたスライドを手軽に作る - ナレッジエース
おそらく、誰もがやる深夜のWebサーフィンは、究極のところ時間の無駄ではないのかもしれない。 それは、Webで夢をみているのにほかならないのだ。(T.B=リー「Webの創成」より) Created at: 2013-03-02 | Tags: javascript JavaScriptを使ってプレゼンテーション用のスライドを作るためのライブラリは沢山ありますが、現在はReveal.jsが人気のようです。 今回はこのReveal.jsを少し改造して、Markdownでちょっとしたスライドを手軽に作る方法を紹介したいと思います。 Reveal.jsとMarkdown サンプル Reveal.jsのMarkdown機能 Reveal.jsはJavaScript製のMarkdownパーサであるshowdown.jsとmarkdown.jsにより、Markdownによるスライドコンテンツ表記に対応し
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
npm
Githubのマークダウン記法でブログが書けるプラットフォーム『LOGDOWN』 | 100SHIKI
