How Stripe builds interactive docs with Markdoc
At Stripe, our product docs are designed to feel like an application rather than a traditional user manual. For example, we incorporate a user's own API test key into code samples, making it possible to copy and paste code that seamlessly works with the user's own account. We have client-side interactivity, like checklists and collapsible sections. We tailor the content to the individual user, con
GitHub - microsoft/vscode-markdown-languageservice: The language service that powers VS Code's Markdown support, extracted so that it can be reused by other editors and tools
This library targets CommonMark. Support for other Markdown dialects and extensions is not within the scope of this project. Currently supported language features: Document links (clickable spans in the editor) Supported links include: Links to headers within the current file: [text](#header) Absolute and relative links to files: [text](path/to/file.md) Reference links: [text][link-name] Document
Diagram as Code
Diagram as Code6 different ways to turn code into beautiful architecture diagrams
June 2022 (version 1.69)
Update 1.69.1: The update addresses these issues. Update 1.69.2: The update addresses these issues. Downloads: Windows: x64 Arm64 | Mac: Universal Intel silicon | Linux: deb rpm tarball Arm snap Welcome to the June 2022 release of Visual Studio Code. There are many updates in this version that we hope you'll like, some of the key highlights include: 3-way merge editor - Resolve merge conflicts wit
Visual Studio CodeがMarkdownのサポートを強化。ファイルのドロップでリンクを自動作成、見出しへの参照一覧など。Visual Studio Code 1.67（April 2022）
Visual Studio CodeがMarkdownのサポートを強化。ファイルのドロップでリンクを自動作成、見出しへの参照一覧など。Visual Studio Code 1.67（April 2022） マイクロソフトはコードエディタVisual Studio Code（以下、VSCode）の最新版となるバージョン1.67（2022年4月）をリリースしました。 The April release of @code is here! Check out the latest: Explorer file nesting Toggle inlay hints Markdown code navigation ... & much more! Release notes: https://t.co/VAPbRhj2U4 Download: https://t.co/1CSkQpMbwd pic
GitHub+VSCodeでのMarkdownドキュメンテーションのプロジェクトルールを考える
概要 Word や Excel でのドキュメント作成を回避し、なるべく生産性高く、かつ、OS 環境依存なく、すべて基本無料で構成できるツールで、Markdown ベースで設計書を作成することを考えてみます。 GitHub 上で閲覧できる形でドキュメントを作成することを前提に、VSCode（＋プラグイン）を用いて、テキスト文書、表（テーブル）、図（構成図など）、キャプチャ、などをスピーディに作成し、PullRequest ベースで運用していけるように、プラグインを構成および、レギュレーションを作成してみました。 GitHub の README.md や Wiki に書いて使えるかと思いますので、併せて markdown 形式および、vscode のプラグイン推奨設定ファイル形式でも載せておきます。 もし、もっとこのプラグインを使うと良い、などアイデアなどありましたら教えていただけると幸いです
74thの技術同人誌執筆環境（Markdown+Vivliostyle+VS Code）
これは Visual Studio Code Advent Calendar 2021 の19日目の記事です。 技術記事や、技術書を書くことが多数あります。技術書典11では、以下を執筆していました。 今も技術書典12に向けて、執筆を続けています。ここで使っているツールセットを紹介したいと思います。 CSS組版 Vivliostyle で Markdown をPDFにする HTML&CSSで組版ができる Vivliostyle を使っています。 Vivliostyle は CLI ツールが提供されており、これを使うことで、執筆環境を簡単に整えたり、1コマンドでPDFをビルドできたりします。 執筆環境を整えるには、Create Bookを使います。 以下のコマンドでビルドするための環境が整います。 このコマンドでできた環境では、npmに付属するタスクランナーでビルドコマンドが組まれています。そ
はてな記法のシンタックスハイライトに対応したVS Code拡張を作った - stefafafan の fa は3つです
このエントリははてなエンジニアAdvent Calendar 2021の10日目の記事です。今回はVisual Studio Code向けの拡張を作った話を書きます。 拡張の様子 はてな記法そこそこ使っている 自分ははてな社員というのもあり、自社のサービスをちゃんと使っておきたいという気持ちで個人ブログもはてな記法モードで書いています。 ただ普段コード書くときはVS Codeで書いており、VS Codeは現状はてな記法で書かれた文章は認識してくれないので、中々手元で書くモチベーションがあがらない。 また、VS Code拡張作ってる人々が周辺にいたので自分も作ってみたいかもと数日前に突如思い立ちました。 ということで作った 作りました。いますぐインストールしましょう。 marketplace.visualstudio.com ソースコードはこちらです。 github.com 見どころ 見どこ
Markdownでスライドを作るツールのFusumaのv2をリリースをしました - 技術探し
リポジトリ: github.com 今回の変更では、面倒事を減らしスライド作成に集中できるようにすることを目標にしていました。 Fusumaとは？ #0CJS MDX(Markdown + JSX(optional)) を使いスライドを作れる プレゼンターモードの提供(なぜかTwitter流せたりや落書きもできる) 音声録音とスライドの操作記録を保存できる github pagesへのデプロイがメインで、pdfでも出力可能 大きな変更 og:imageを自動生成/設定するようにしました ogp用に画像を設定するのがめんどくさいという意見があり、自動的に生成するように追加しました。現在はスライドの1ページ目を画像化しています。 ユーザー側へCSS Variablesを提供しました v1では、publicで外に出さずに自由にcssを書いてもらうようにしていましたが、0から書くのはめんどくさい部
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-
【VS Code + Marp】Markdownから爆速・自由自在なデザインで、プレゼンスライドを作る - Qiita
TL;DR Visual Studio Code上で、Markdownから、こんな感じのデッキを生成できるようにします。 使用したファイル類は、GitHub tomo-makes/marp-styles にまとめました。 きっかけ 叩き台となる資料がなく、急ぎプレゼンをする機会があり、Marpで作成した 内輪では使っていたが、多くの目に触れるのは初めてで、もう少しデザインを調整したいと思った 今後も使いまわせるものを、スニペット、およびサンプルテーマ化しておこうと思い立った ついでにいろいろな図表の生成とデッキへの入れ方、必要そうな配色、素材のリンクをまとめておきたい Marpとは Marp: Markdown Presentation Ecosystem Markdownから、プレゼンスライドを生成してくれるツールです。 当初Electron製アプリとして開発されました。その後、より汎用
MarkDeck - presentations as code
MarkDeck presentations as code author cool slide decks, text-only, offline-ready, collaborative Try Markdeck converts markdown to a clean html5 slide deck cool looking: based on battle-proven web frameworks, like reveal.js no uplink required, neither when authoring, nor presenting: no awkward moments during presentation (no "I am still waiting for the Internet, sorry!") batteries included: live re
会議を爆速にする、Visual Studio Code 超便利スニペット集 - Qiita
以前の投稿でVisual Studio CodeとMarkdown Preview Enhanced環境を組み合わせの便利さを紹介しました。 議事メモを作成にマークダウンを使うと、議論が構造化されて表示されるので、非常にわかりやすくなりますね。みなさんもお使いかと思います。本稿では、そこに、更にVisual Studio Codeにマークダウン用のスニペットを登録しておくことを提案します。 出席者の議論をフォーカスさせる図や表がスムーズに呼び出せますので、効率的な会議を行うことができます。そんな爆速会議に便利なスニペットをいくつか紹介します。 以下ではVisual Studio CodeエディタとMarkdown Preview Enhancedプラグインが前提となっております。環境構築には以前の投稿をご参照ください。 1.会議を一気に立ち上げる：議事録スニペット まずは議事録のテンプレー
VS Codeを極める！ MarkdownやGitにもオススメの拡張機能9選 - ICS MEDIA
「Visual Studio Code（略称：VS Code）」はMicrosoftが提供している無償で高機能なエディターです。標準でも十分な機能は備わっていますが、拡張機能をインストールすることで、より使いやすく自分にあったエディターにカスタマイズできます。 前回の記事では、「HTMLコーダー」「フロントエンジニア」に役立つ拡張機能を紹介しました。本記事では、開発者全般の方に役立つ拡張機能を紹介します。 エディターを強化する拡張機能 1. Clipboard Ring テキストを「コピー」や「切り取り（カット）」したものを「貼り付け（ペースト）」する場合に、この拡張機能を入れることで複数件の内容を記憶できます。ctrl+shift+v（⌘+shift+v）を押すごとに過去の情報に切り替えられます。デフォルトでは10件の情報を記憶できますが、設定を変更することで記憶する件数を増やすことも可
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
GitHub - egoist/docup: The easiest way to write beautiful docs.