Markdown

友人と開発中のWebサービスのAPIドキュメントをどのように公開するか?というのが少し前から迷っていました。候補は次のもの。

  • WordPress
  • StaticなWebページ
  • Confluece
  • Markdownで書いてGitリポジトリ

手軽に更新ができて、更新されたことを利用側も簡単に分かるようにしたいというのと、できるだけ手間をかけたくないという点などを考慮して、Markdownでやってみることにしました。
問題は、GitのリポジトリをBitBucketに置くので、BitBucketのサイト上でMarkdownファイルがどの程度プレビューで表示されるのかという点でした。実際に試してみると、大体は期待通りの感じです。まだ、書き始めなので画像などはどうのか?やコードは?などは未確認です。ただ、テーブルは罫線が出ないという点が不満ですが、やり方が何かあるような気もします。
まだ、非公開リポジトリですが、そのサービスが公開された後はパブリックにして、ブラウザのエクステンションやネイティブアプリの開発に使えれば良いなぁと想像しています。

関連記事

  1. [お知らせ] セミナー中止のお知らせ

  2. Apple Watchのアクティビティがいい!

  3. Simplicityをアップデート

  4. Parallels Desktop 9 の Windows を分離する…

  5. Lion Recovery Disk Assistantが公開されたよ…

  6. Mac版のWordで設計書を作るとき

最近の著書

  1. 基礎から学ぶ SwiftUI

最近の記事

  1. 2020.10.21

    GitLabへの移行
  2. 基礎から学ぶ SwiftUI
  3. 基礎から学ぶ SwiftUI