はじめに Markdownって便利ですよね？ README.md、PR や Issue の本文やコメント、Qiita や Zenn はもちろん、Google Docs や Trello や Notion や Jupyter Notebook でも使えるみたいです。もっといろいろな文書を Markdown で書ければいいのになあ、あらゆる文書のソースコードを Markdown にできればいいのになあ。 さあ、Markdown の可能性を広げましょう！ 本記事では「スライド」と「(電子)書籍」をMarkdownで書く方法をご紹介したいと思います。もちろん、VSCodeでMarkdownを効率よく便利に書いていくためのチップスもご紹介していきますよ。 ご参考スライド VS Code Conference Japan 2021 で発表した際の以下スライドもご参照ください。 もちろんこのスライドもV

作成方法 目次を自動で作成するために以下の拡張機能を使用します。 インストール後にMarkdownファイルの目次を挿入したい箇所にカーソルを合わせます。 コマンドパレットでMarkdown All in One: Create Table of Contentsを実行します。 すると以下のように目次が挿入されます。 # タイトル ## 目次 - [タイトル](#タイトル) - [目次](#目次) - [セクション1](#セクション1) - [セクション1-1](#セクション1-1) - [セクション1-2](#セクション1-2) - [セクション2](#セクション2) - [セクション3](#セクション3) ## セクション1 ### セクション1-1 ### セクション1-2 ## セクション2 ## セクション3

こんなやつ。 前置き GitHubプロフィールに関する記事は珍しくはありません。 有名どころの記事だとこんな記事があります。 GitHubProfileのページを可能な限りキラキラさせる方法 だがしかし！ 拙者には、とくに素晴らしい実績がない。 だからこの記事の著者のように格好良いトロフィーとかは載っけられない。 「それでも、なんかいい感じのGitHubプロフィールを作りたい...!!」 ...ということで、今回は何の実績のない方でも作れる一番シンプルなGitHubプロフィールのレシピです。 カップ麺にお湯を入れて待っている間にできるかもしれません。 ぜひ読みながら一緒にGitHubプロフィールを作ってみてください。 GitHubプロフィールのレシピ 下記のWebサイトにアクセスして必要な項目を全て埋めた後、「GenerateREADME」のボタンを押します。 GitHub Profile

AWS が提供するサービスを組み合わせて、Git で管理された Markdown を PDF に一括変換する CI/CD パイプラインを構築した。 パイプライン構成図 処理フロー Markdown を含むファイルを Git で CodeCommit のリポジトリにプッシュ CodeBuild で CodeCommit から Markdown を含むソース一式を取得 ECR にある Pandoc の Docker イメージを利用して Markdown から PDF に変換 PDFをまとめて zip に圧縮し S3 へ転送 パイプライン構築手順 【注意】各種サービスのリージョンは同一リージョンに揃える必要がある S3 生成したPDFを格納するS3バケットを構築する。特に注意点はなし。 ECR Pandoc の Docker イメージをプッシュするためのレジストリを予め作成しておき、Docker

【VS Code + Marp】Markdownから爆速・自由自在なデザインで、プレゼンスライドを作るMarkdownVisualStudioCodeDraw.ioMarpvega TL;DR Visual Studio Code上で、Markdownから、こんな感じのデッキを生成できるようにします。 使用したファイル類は、GitHub tomo-makes/marp-styles にまとめました。 きっかけ 叩き台となる資料がなく、急ぎプレゼンをする機会があり、Marpで作成した 内輪では使っていたが、多くの目に触れるのは初めてで、もう少しデザインを調整したいと思った 今後も使いまわせるものを、スニペット、およびサンプルテーマ化しておこうと思い立った ついでにいろいろな図表の生成とデッキへの入れ方、必要そうな配色、素材のリンクをまとめておきたい Marpとは Marp: Markdown

VP of Technology の星 (@kani_b) です。技術基盤や研究開発領域などを担当しつつ、社内の色々なことを技術の力でいい感じにする仕事をしています。セキュリティや AWS の話が好きです。 さて、みなさんは、ご自身が勤務する会社の就業規則を読んだことはあるでしょうか。 エンジニアに限らず、会社の全スタッフが仕事をする上で関わってくるのが、就業規則や情報セキュリティドキュメントなど、会社のルールや規程を記す文書です。 特にセキュリティやインフラに携わるエンジニアは、その改訂も含め携わったことがある方もいるのではと思います。 よくある文書管理 こうした文書は、以下のように管理されていることが多いようです。 ベースドキュメントは Word 保存時は PDF で保存 版管理は Word の編集履歴 + PDF に保存する際のファイル名 編集は担当部門, 担当者のみが行う かつての

こんにちは、QAエンジニアの井上恵一です。好きな飲み物は一番搾りと韃靼そば茶です。 初回からニッチなネタではありますが、昨年入社した直後に行った、 iPad アプリのテスト仕様書の管理方法を見直したときの話を紹介しようと思います。 見直しのきっかけ トレタは飲食店向けの予約/顧客台帳アプリです。だれでもかんたんに使いこなせるシンプルさを追求してはいますが、製品の進化に伴ってそのテストケース数はすでに数千という単位にまで膨れあがっています。 製品の品質を安定させるためには、テストの内容自体をブラッシュアップすることが重要なのは言うまでもありません。ただ、安定した製品を永続的に提供していくためには、それに加えて、膨大なテストケースを効率よくメンテナンスし続けるためのプロセス作りも欠かせません。 入社のタイミングでトレタのテスト設計を担当することになったので、テストケースの管理方法についてもいち

この記事はドワンゴ Advent Calendar 2017 24日目の記事です。メリークリスマス！ ドワンゴ 技術コミュニケーション室の塩谷（ @kwappa / [email protected] ）です。 先日、技術コミュニケーション室のメンバーから「友人が転職を検討しているが、職務経歴書の書き方がわからず悩んでいる」という相談を受けました。ぼくは以前から職務経歴書についてはなんども書いたり喋ったりしてきたのですが、具体的な書き方やサンプルについてまとめたものはなかったので、この記事を書くことにしました。 以下は、ぼくが以前から考えていることと、書類選考をするときに書いてあると嬉しいことをまとめたものです。会社としてオフィシャルに定めた基準ではないことをご了承ください。 転職に必要な書類 中途採用に応募する場合、「履歴書」と「職務経歴書」が必要です。転職サービスを経由しての応募の

Boostnoteの記事一覧をまとめました。 お問い合わせなどありましたらこちらまでよろしくお願いします。 ・Twitter ・Facebook ・Reddit はじめに Boostnoteコミュニティの紹介 Boostnoteの各コミュニティのまとめです。 コミュニティ上で最新記事を発信しているので、ぜひ参加していただけると嬉しいです。 boostnote.hatenablog.com 記事一覧 基本的な使い方 ノートの作成方法と設置画面 上記の2つの主な機能の使い方と、Boostnoteのデザインやフォント、エディタのモードなどを変更方法を紹介している記事です。 boostnote.hatenablog.com Boostnoteのメモを、クラウド上に同期する方法。 Boostnoteは、何も設定しなければlocal storageにデータが保存されるようになっているのですが、 Dro

1ファイルのMarkdownからPDFやEPUBを生成するドキュメントツール、Cheepubというツールを作りました。 Cheepub: https://github.com/takahashim/cheepub 特徴 一言で言えば「MarkdownでRe:VIEWみたいなことを簡単にやりたい！」という人のための、Re:VIEWの劣化版（機能限定版）みたいなやつです。 設定ファイルを別に作ったり、Markdownファイルを複数に分割したりせず、1ファイルだけで完結します Jekyllのfrontmatterみたいなやつで、YAML的な設定を書けます ベージ分割はhorizontal line(HTMLで言うところの<hr />)の拡張で対応しています PDF生成にはLaTeXを使っていて、標準で縦書き・2段組に対応します front-matterでいろいろ書けばできます。styファイルはな

Get HackMD free HackMD is my go-to thinkpad. It's been a great fit for everything from TODO lists to Ethereum devnet specs, drafting blog posts and all types of internal org docs. It's a simple yet versatile product that's a core part of all my workflows!Tim Beiko,Ethereum Foundation Accelerate innovation, foster community, and supercharge collaboration with your go-to Markdown editor. DocsTake no

家で野生のカビゴンが出てきて無事にGetできて、ここ最近で一番興奮した中村です、こんにちは。 今日は、リアルタイムでテキスト共同編集ができるMarkdownエディタ「HackMD」というOSSツールをhackしてみたので、そのhack方法についてご紹介します！　HackMDは、ヌーラボのリモートワークやミーティングでの議事録ツールとしても活用しており、導入の背景や他のツールとの使用比較についてもまとめました。 背景：オンラインでのリアルタイムコミュニケーションを円滑に ヌーラボは、国内だけでも福岡・東京・京都、さらに海外も含めるとニューヨーク・台湾・シンガポールなど、各地域に拠点があり、たくさんのスタッフがいます。拠点間でも、朝会など日常的にコミュニケーションが発生するので、face to faceじゃなくともオンラインでうまくコミュニケーションできる仕組みを必要としています。 今ヌーラボ

MarkdownでSlide作成して自分のGitHub Pagesで公開する奴を作りました。 資料がアチラコチラに散らばることがなく、テキストでGitなので差分が見れたりと結構便利です。 動きがあるスライドなどは辛いですが、さくっと作る時には良いかと思いますので良かったら使ってみてください。 忙しい人用まとめ SlideをMarkdownで書いて自分のGitHubで管理して、自分のGitHub Pagesで表示できるようにした。 reveal.js version 3.5.0を使用 毎回HTMLとか書きたくないので、Markdownのパスを指定すればスライドが表示されるようにした。 真似したい人は、リポジトリをForkやCloneして、GitHub Pagesで公開すればすぐ使えます。（↓に使い方書いてます） https://github.com/yamap55/SlideWithGitH

書式の自由が社会を変える―LibreOfficeとPandocができること 藤原 由来 2017年4月29日 自己紹介 名前 藤原 由来 (本名, GitHub) 藤原 惟（ブログ） すかいゆき（Twitter） 職業 フリープログラマ 専門学校 非常勤講師 Pandocに関する活動 Qiitaを中心に記事執筆 多様なフォーマットに対応！ドキュメント変換ツールPandocを知ろう - Qiita Pandocユーザーズガイドを和訳 Pandoc ユーザーズガイド 日本語版 バージョンが古くなったので、改訂を予定 日本Pandocユーザ会 最近Slack作りました: Slack登録フォーム Pandoc公式サイト Pandoc - About pandoc ユーザーズガイド Pandoc - Pandoc User’s Guide Pandoc ユーザーズガイド 日本語版 Pandocと私

Markdown Night 2017 Summer - connpass 自己紹介 藤吾郎（@__gfx__） Bit Journeyのエンジニア Kibela を開発中 WikiとBlogが別れているのが特徴の情報共有ツール 最近はKibela MarkdownのCommonMark化をしたり非公開boardの実装をしたりした 第一部: Markdown小史 多くのサービスで利用できる軽量マークアップ言語 GitHub, Qiita, esa.io, Slack, stackoverflow, Reddit, Confluence... KibelaもMarkdown採用サービスのひとつ 処理系ごとの 方言が非常に多い ことで知られる 構文そのものの違い たとえばテーブル記法をサポートしている処理系は比較的少ない 構文の微妙な差の方言 スペースの要不要はエッジケースを含めるとかなり違う

You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert

はじめに あるプロジェクトで仕様書をそれなりのクオリティで書く必要が出てきました。Markdownで書きたいなーとか履歴管理したいなーと思っていたので、GitHubで管理してGitBookとしてドキュメント化することに決めました。 内容 GitBookとは？ 「Markdownで簡単に電子書籍が作れるよ」というものです。GitHubのレポジトリを指定すると勝手にホスティングしてくれる gitbook.com というサービスの他に、OSSでも公開されているので自前の構築も可能です。 gitbook.com を使えばかなり楽が出来ますが、以下の2点が問題点としてありました。 確認した時点で日本語ディレクトリだと正常に動かなかった ほかの人(主にクライアント)に見せるためにprivateで構築してコラボレーターに追加するのが面倒 そこで今回はOSS版のGitBookを活用し、自前で構築しました。