[Apiary]Markdownで始めるAPI開発とAPIドキュメント作成 | DevelopersIO
APIを作るとき みなさん、毎日API使ってますか？私は、ワンライナーでAPIをコールすることにハマっています。さて、いつも使っているAPIを作る側になったとき、どのように設計していますでしょうか？また、作ったAPIをどのように使ってもらっていますか？そんな疑問に応えるサービスがApiaryです。 Apiaryとは？ Apiaryは、REST APIをサクッと書けるサービスです。また、APIドキュメントも生成してくれます。モックサーバも提供してくれます。API利用サンプルコードも作ってくれます。うん、使わないって選択肢は無いですねｗ。 無料登録すると早速使えるようになります。チームでプライベートなAPI開発をしたければ有料プランを選択してください。 API開発の流れ API開発の流れは、まずはじめにMarkdown形式でドキュメントを書きます。既にサンプルがあるのでこれを使ってみましょう。
![[Apiary]Markdownで始めるAPI開発とAPIドキュメント作成 | DevelopersIO](https://cdn-ak-scissors.b.st-hatena.com/image/square/60d7120d91185f1739fec5fcbd006f066b98e9f6/height=288;version=1;width=512/https%3A%2F%2Fdevio2023-media.developers.io%2Fwp-content%2Fuploads%2F2015%2F02%2Fapiary-logo.png){kind=logo}
Qiita:Team と比較して esa.io の方が圧倒的に優れてる機能3点 (\\( ⁰⊖⁰)/) - kakakakakku blog
プロダクトで CQO を担当していて，Qiita:Team をこよなく愛す僕ですが，食わず嫌いは良くないなということで，esa.io をトライアルで使ってみた． 実際にポストしてみたり，ヘルプを見てみて，基本的なところは Qiita:Team と似てるなーという印象を受けたんだけど，Qiita:Team と比較して esa.io の方が圧倒的に優れてるなと思う機能を3点を知ってしまったので，熱量高くまとめてみた．まぁ圧倒的は言い過ぎたかもwww 1. カテゴリーという概念があること esa.io のポストは，タグ以外にカテゴリーというメタ情報を付けることができて，これは便利． Qiita:Team だとタグしかないので，例えば日報のように時系列に沿った情報を探したりすることができず，結構ポストが埋没する傾向にあるという課題はどこのプロダクトでもあるんじゃないかなと思う． ちなみに Qiit
ブラウザ上でMarkdownを安全に展開する - 葉っぱ日記
不特定のユーザーが入力したMarkdownをブラウザ上でJavaScriptを使ってHTMLに変換するという場面においては、JavaScriptで変換してHTMLを生成するという処理の都合上どうしてもDOM-based XSSの発生を考えないわけにはいかない。かといって、MarkdownをパースしHTMLを生成するという処理すべてをXSSが存在しないように注意しながら自分で書くのも大変だし、markedやmarkdown-jsなどの既存の変換用のJSを持ってきてもそれらがXSSしないかを確認するのは結構大変だったりする。 そういった場合には、Markdownから生成されたHTMLをRickDOMを通すことで、万が一HTML内にJavaScriptが含まれていたとしてもそれらを除外し、許可された要素、許可された属性だけで構築された安全なHTMLに再構築することができる。さらに、そうやって生成
Qiita Markdownのコードハイライト部分にXSS脆弱性 - Qiita
はじめてQiitaに日記を投稿します。よろしくお願いします。 先日友人から「レポートを生成するためにQiita Markdownを使っているが、どこかにXSSがある気がする」という話を聞き、これは面白そうだとQiitaを覗きに来てみると、投稿画面にはプレビュー機能が付いているようです。Qiita Markdownをインストールする手間が省けたぞと喜んだあと、Qiita Markdownには一体どんな追加機能があるのだろうかとGoogleというサイトで検索して調べました。 技術系の記事を投稿するためのサービスなだけあって、真っ先にコードハイライトするための記法が見つかったので、それをQiitaの投稿ページに入力してみました。
Macでよかった！自由に設定できるHTML入力支援ツール「Dash」で記事作成スピード爆速化
ども、ゆうせいです。文章作成スピードは速い方だと勝手に思っていますが、実はそれには理由があるのです。面倒なHTMLなどのタグを一瞬で展開し、タグとタグの間にクリップボードの文言を挿入したり、それらを全部アプリにまかせているからなんです。 というわけで、Macの無料アプリ「Dash」を使って、文章作成スピードを爆速にしようぜって話をします。 補足と言ってはなんですが、 “文章入力スピードをｎ倍速くする「Markdown記法」について語ろう” って記事も書いていますので、お好みで選んでいただければと思います。 HTMLのタグをポチポチ打つのしんどい！ しんどいってのは正直なところ言い過ぎましたが、これを覚えてしまうともう無しではしんどいのが実状です。 たとえば、見出しを設定するときのHTMLタグは、 <h2>見出し</h2> ですよね。 これって、どうやって書いてます？ 一文字ずつポチポチと
快適 Markdown ライフを送ろう！Mac で使える Markdown 支援ツール6選 | DevelopersIO
Markdown 形式のドキュメントを快適に書こう ちょっとしたメモから Wiki のような文書まで、幅広く利用されている Markdown。私も簡単なメモなどや外部メディア記事の原稿の執筆などに利用しています。 適当なテキストエディタで適当に書くだけでも良いのですが、Mac で Markdown 形式のドキュメントを書く上で便利そうなツール (プラグイン) がいくつかあったので、個人的なまとめを公開したいと思います。 Sublime Text 3 + 各種プラグイン Markdown 形式のドキュメントの作成には、主に Sublime Text 3 を使っています。Sublime Text は言わずと知れた有名テキストエディタで、今やテキストエディタの代表格にまで上り詰めました。バージョン2で一躍有名となり、現在はバージョン3が主流になっています。 Package Control のイン
Markdownを拡張して独自記法をつくる - Qiita
Qiita::Markdownの解説記事です。Markdown拡張ならHTML::Pipelineという旨の投稿です。 いま読んでいるこの投稿の描画にもQiita::Markdownが利用されています。 方言とライブラリ Markdownには様々な種類・方言があり、最近ではStandard Markdown is now Common Markdownが一部で話題になったりしました。かいつまんで言うと「Markdownの方言多すぎるしStandard Markdownって名前で共同プロジェクトつくろうとしたけど紆余曲折あって結局CommonMarkって名前になったわ」という感じです。 MarkdownをHTMLに変換するためのライブラリを探すと、例えばRubyではRedcarpet、C言語では同作者のSundown等が有名なところです。GitHubが利用しているライブラリgithub-ma
勉強会でのメモの取り方について
この記事では自分なりの勉強会でのメモの取り方についてメモしたものです。 今までに参加してきたイベントでは、 大体メモを取っていて”〜アウトラインメモ”とかいうタイトルで公開してあります。 書くツール メモを取るにはエディタとかツールが結構大事で、書くのに集中し過ぎると話をちゃんと聞けないし、 話に集中してるとメモを書かなくなったりします。 なので、画面を見なくても入力できるような手に馴染む感じのツールを見つけて使うのがいいと思います。 以下が使ってきたツールの変遷ですが、出力は常にMarkdownにしていたので、 基本的にはMarkdownエディタが中心となってます。 Qute for PC/Mac Mou なんだかんだ一番使ってた Markdown Life Haroo Pad Texts OmniOutliner アウトライン的に使う場合、MarkdownエディタだとMouが安定して使
Markdownでプレゼン用スライドをつくる方法いろいろ - Qiita
勉強会での発表資料を作成するにあたり、まずMarkdownで話そうと思うことを適当にメモしてるうちに、なんか発表資料このままで良くない？と思えてきました。別に レイアウトや配色のセンスに自信があるわけでもない し。。 で、最初 "markdown pagination" でググってみるとあまりパッとしたのがなかったのですが、"markdown presentation" にしてみると出るわ出るわ。しかもどれも結構よさげ。 というわけで出てきたものをメモがてら書き留めておきます。結論からいうとググって一番上に出てきた "Remark" が今回の要件に（ほぼ）マッチしていたので、他はまだ使ってません。 Remark 長所 GitHubでソース公開されてる 無料 ログイン不要 不満があれば自分で修正してpull request送れる Swipe 長所 テンプレートやフォントが複数用意されてる（っ
Standard Markdown
What is Markdown? Markdown is a plain text format for writing structured documents, based on conventions used for indicating formatting in email and usenet posts. It was developed in 2004 by John Gruber, who wrote the first markdown-to-html converter in Perl, and it soon became widely used in websites. by 2014 there were dozens of implementations in many languages. Digital data in any form needs p
Markdownからスライド資料を作る
B! 460 0 1 0 何か人に見せる時には資料としてPower Pointとかでスライドを作るわけですが、 普段メモもMarkdown形式で書いてく事が多くて、 簡単なもの、特に文字だけの物の場合はそのままコピペするだけみたいな ことも多いので、 直接Markdownからスライドを作る物を試してみることに。 Markdownからスライドを作れるツール Pandoc 対応フォーマット インストール PDF作成(beamerテンプレートを使う) beamerのテーマについて 日本語について Pandocまとめ Slide Show (S9) インストール スライド用HTML作成 PDFにコンバート その他のツール Marp mkd2pdf markdown-pdf markdown2impress mdslide slidedeck remark Markdown2pdf Swipe Sl
文章の書き方を変えるだけで社内の情報共有は加速する - UNIX的なアレ
社内の情報共有で困っている会社は多いみたいですね。でも実は、nanapiという会社ではそこまで困っていなかったりします。元々文章を扱う会社というのもありますし、ドキュメント化して共有しようという風土が染み付いているからだと思います。 そういったこともあり最近登壇するときなど、社内の情報発信などについて話す機会が増えました。弊社では社内における情報共有のツールとして、Qiita:Teamを使用しています。 生産性を向上させる情報共有ツール - キータチーム（Qiita Team） 全員がMarkdownで文章を書く 実際にnanapiではQiita:Teamを導入してから、現在ではエンジニアだけでなくアルバイトも含めた全社員がここに様々なドキュメントを投稿しています。 Qiita:TeamはMarkdownで書けるようになっています。つまり、社内のメンバーは全員がMarkdownで文章を書く
もっとはやく知りたかったGoogle Driveで仕事を爆速させる使い方＆ツールまとめ | SIROKグロースハックブログ
みなさんGoogle Drive使ってますか？Google Driveにはいろいろな機能や便利な使い方があるので今回はその中でも特に知らないと損する便利な機能を一挙紹介します。 Google Drive の拡張アプリ モックアップを簡単に作れるCacoo Chromeウェブストア – Cacoo ワイヤーフレーム作成を簡単にしてくれるツールの一つです。上の画像のように簡単に分かりやすくクオリティーが高いものを仕上げることができます。 Markdownで文章が書けるStackEdit Chromeウェブストア - StackEdit Mardownで書けるのでエンジニアの方にはすごい便利かもしれません。またその後TumblrやGithub、Gistなどにも公開できるのでとても便利です。ブログの記事の下書きなどにもすごい向いているかもしれません。 Google DriveからFAX送信ができ
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
拡張記法に対応しWin/Mac/Linuxで動作するMarkdownエディター「Haroopad」NOT SUPPORTED
Online Markdown Editor - Dillinger, the Last Markdown Editor ever.
Apiary | Platform for API Design, Development & Documentation
sakedrink.info
Markdownドキュメントを扱えるWindows ストアアプリ「Markdown Editor」NOT SUPPORTED
GitHub（ギットハブ）の使い方：issue（イシュー）編
Kobito - プログラミングのメモやスニペットの記録に最適なMacアプリケーション