はじめに X 上で見かけた 「もう Markdown じゃなくて HTML でドキュメント書いた方がよくない？」 系の議論（@trq212 のポスト等）には、まったく同感です。 というのも、自分は もう半年ほど前から、Claude CodeにHTMLでドキュメント生成させています。エージェントを使えばつかうほど、その生成物を直接人間が修正することが減るからです。プランファイルがその典型で、プランがまちがっていたらそれはAIに指示して修正させるべきで手動修正するべきではないのです。その理由は手間を減らしたいからではなく、「なぜそう出力されたか」の理由にたちもどって指示しないとAIは同じ間違いをくりかえしてしまうからです。そうすることで人間はAIと思考を共有することができます。 その場合、Markdownは人間が作成も修正することはなくなるわけで、Markdown形式がドキュメントの形式として

ローカルのMarkdownメモやコードファイルを、ブラウザから閲覧・編集できる軽量なWebアプリを作りました。名前は「workspace-web-editor」です（そのまま）。 特徴をひとことで言うと、Obsidianのような Wiki-link / Backlinks / Quick Switcher を、自分のMarkdownディレクトリに対してブラウザから使えるようにしたものです。Tailscale越しでスマホからも編集できるので、夜の散歩中にメモを直したりもできます。 動機 Claude CodeなどのAIコーディングツールを使うようになり、ローカルのMarkdownファイルがで大量に増えました。少し前までは、Obsidianを使ってObsidianのTerminal拡張からClaude Codeを使うようなことをしていました。 ときはたち（といっても数ヶ月ですが）、最近自宅のP

とうとうMarkdown viewerまで作ってしまったhttps://t.co/sRCvH0Lsdt - CLI起点でMarkdownを開きたい - Markdownはブラウザで見たい - Markdownを開くたびに別プロセス/別ポートが使用されないようにしたい - グルーピングもしたい というOpinionatedな特性を持つ実装 pic.twitter.com/2vTs578fV3— k1LoW (@k1LoW) 2026年2月27日 OpinionatedなMarkdown viewer 世の中にMarkdown viewerはたくさんありますが、自分がほしかったのは以下の特性を持つものでした。 CLIからMarkdownを開きたい Markdownはブラウザで見たい（ローカルWebサーバ方式） Markdownを開くたびに別プロセス/別ポートが使用されないようにしたい グルーピ

BIをコード管理したくないですか？私はしたいです。 BI as Codeを謳うOSSがあるようなので、Get Startedしてみます。 環境構築 公式ドキュメントを見ると、VSCodeのExtensionを入れて開発することを推奨しているようです。 2.Open the Command Palette (Ctrl/Cmd + Shift + P) and enter Evidence: New Evidence Project 3.Click Start Evidence in the bottom status bar 拡張機能のインストール後、2クリックでローカルサーバーが起動しサンプルページが立ち上がりました。 外部データを投入する せっかくなのでサンプルデータ以外のデータを投入してみます。 初期のサンプルデータは、DuckDBのテーブルとして配布されているようです。 ローカル環境

ブログの文章やドキュメント作成など、さまざまなシーンで使われる記法に「マークダウン記法」があります。文字修飾の簡単さや読みやすさから使うタイミングは多々あると思いますが、みなさんは快適にマークダウンを書けていますか？ 筆者はVS Codeでドキュメントをマークダウンで書くことが多く、表の作成・編集やプレビュー表示など、めんどくさい・見づらい・使いづらいと思うことがあります。どうにか快適に書けないかと思いさまざまな拡張機能や設定を試しながら業務を行ってきました。 この記事では、筆者が試した拡張機能やVS Codeの設定の中で便利だったものを紹介します。①から⑥まではすべて無料で利用できるので気軽に試してみてください！ ①マークダウンの表をエクセルからコピペできる拡張機能 VS Codeでの表の作成に重宝しているのが「Excel to Markdown table」という拡張機能です。エクセル

こんにちは、臼田です。 みなさん、業務設計してますか？(挨拶 今回はMarkdownでシーケンス図やフローチャートなどの図を記述できるMermaidを使って業務フローを書いてみたら、意外と書けたので自分なりのTipsを紹介したいと思います。 その前に 注意点として、まだMermaidを使い始めたばかりなので、「もっとこうしたらいいぞ」とか「こっちのほうがいいぞ」とかあれば建設的なフィードバックとしてSNSとかでいただけるとありがたいです。 あと業務フローって表現しましたが、人によって思い描く業務フローが違うと思うので、業務フローの定義に関するツッコミはご容赦ください。私が今回Mermaidで書いたのは以下の図です。(内容はブログ用に簡素化しました) この図のコードは以下のとおりです。(後ほど解説します) sequenceDiagram autonumber actor お客様 partic

ExcelやGoogleスプレッドシートをMarkdown出力するVS Codeの拡張機能「Excel to Markdown table」が便利すぎる件 Markdownでテーブルを表現するにはつらみが深すぎる みなさんはMarkdownでテーブルを書くことは得意ですか? 私は苦手です。 簡単なテーブルは簡単に書けるのですが、以下のようなテーブルを書くことには抵抗感があります。 行数、列数が多い セル内に書くテキスト量が多い セル内でリストを表現する 一方、私は先日、「Markdownで手順を書いています!」とこちらの記事で伝えました。 そんな私に対して、 「オイオイオイ。 Markdownでもなんでもいいけどよォ... テーブルを使いたい場面は多いんだぜ。」 というセリフが聞こえてくる気がします。 私のようなMarkdownでテーブルを書くことにつらみを覚える方への解決策として、以下記

こんにちは丸山@h13i32maruです。システム全体を簡単な図とテキストでまとめる「ARCHITECTURE.md」というものを最近知りました。これは良さそうと思い、JasperのARCHITECTURE.mdを書いてみました。 jasperapp/jasper/ARCHITECTURE.md ARCHITECTURE.md自体の目的は「プロジェクトへの新規参加者が全体像の把握を効率的に行えるようにする」という感じです。書き方の指針や注意点などは考案者による記事を見てもらうのがよさそうです。また良いサンプルとしてrust-analyzerというOSSのARCHITECTURE.mdが紹介されています。 https://matklad.github.io//2021/02/06/ARCHITECTURE.md.html https://github.com/rust-analyzer/ru

はじめに こんにちは、maKunugiです。 先日、マークダウンを書いて「ドキュメントを書くような感覚」でチャットボットを手軽に作成できる、「mabo」というサービスを開発し、ベータ版を公開しました。ぜひ経緯や内容を共有したいと思い記事を書いてみましたので、チャットボットに興味のある方はぜひ読んでみていただけると嬉しいです！ どんなものを作ったか サービスページ 利用ガイド maboはマークダウンをツラツラと記述するだけで、ブラウザ上で応答可能なチャットボットを簡単に構築できるサービスです。(スマホ・PC両対応) まるでドキュメントを書いているかのような感覚でチャットボットを手軽に構築できるのが特徴です。 チャットボットは公開URLを配布することで、様々なユーザに利用をしてもらうことができます。 （Slack上でも動作します。) なぜ作ったか 数年前にチャットボットブームが到来し、チャット

PCで小説や長い文章を書いたことがある人の中には、シーンとシーンの場面転換がゴチャゴチャになってしまったり、登場人物や場面が多すぎて収拾がつかなくなってしまったりといった経験がある人もいるはず。無料で使用できるオープンソースのテキストエディタ「novelWriter」は、Windowsのエクスプローラーのようなツリー形式でチャプターやシーンを構成することが可能で、Markdown記法で見やすく表示することも可能とのことなので、実際に使ってみました。 novelWriter – A markdown-like editor for writing novels https://novelwriter.io/ ◆インストール 上記のURLにアクセスするとこんな感じ。novelWriterはソフトウェア開発プラットフォームのGitHubで公開されているので、赤枠で囲われた「GitHub」をクリッ

A plain text editor for novels A markdown-like text editor designed for writing novels and larger projects of many smaller plain text documents. It is designed to be a simple text editor that allows for easy organisation of text files and notes, with a meta data syntax for comments, synopsis, and cross-referencing between files, and built on plain text files for robustness.

ソフトウェアに関する記事やコラムを書くなら、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-

どうも、まさとらん（@0310lan）です！ 今回は、単純なマークダウンファイルから動画を生成してダウンロードできるWebサービスをご紹介します！ ブログ記事を書くようにテキストデータを動画に変換できるうえ、自然な日本語音声も自動生成してくれます。また、画像や音楽などのメディアも挿入できるので、チュートリアル動画やPR動画などさまざまな作品を作ることができます。 現在はベータ版で全機能を無料で使えるため、動画作成にご興味がある方はぜひ参考にしてみてください。 【 Video Puppet 】 ■「Video Puppet」の使い方 それでは、最初に「Video Puppet」をどのように使うのか詳しく見ていきましょう！ トップページにアクセスしたら、画面上部にある【SIGN UP】ボタンから無料のユーザー登録をしておきます。 （※登録しなくても制限付きで利用することは可能です） ユーザー名

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

writing.md ラムダノートでの原稿の書き方 記事の執筆には、Markdown形式を利用してください。 Markdownにはさまざまな流派がありますが、GitHub Flavored Markdown（https://github.github.com/gfm/ ）をベースとした書式を採用します。 書籍を執筆するための形式として考えると、Markdownには不足している機能が多々あります。 しかし、次のような利点があるので、Markdownを採用することにします。 最低限の構造しかないので、見た目でごまかせる余地が少ない 原稿を著者自身が再利用してもらいやすくしたい ラムダノートで販売する際のスタイルは、原稿の形式がなんであれ、別に考えなければならない 以下では、節や項といった記事の大構造、および、段落やコードや図表といった記事の小構造について、 執筆にあたって気を付けていただきたい

Markdown to PDF Markdownで書きたいけど、PDFで出力したい という機会はエンジニアはよく出くわすと思います。 「Markdown to PDF」といえばGitBook CLIが有名ですが、こちらはメンテナンスがストップされているため推奨されません（環境依存による不具合などが解決されない）。 GitBookほど多機能でなくても良いですが、綺麗にいい感じに出力したい…！と探し回っていたところ md-to-pdf が最も私の要件に合致したので使ってみました。 そんな私の要件はこちら。 CLIから出力したい ページ内リンクが作れる ページ分割ができる ページ数表示が簡単にできる 全体に対して簡単にテーマをCSSで適用できる いざという時にはHTML+CSSでカスタマイズができる それに対して md-to-pdf は以下のような機能があります。 ディレクトリ内のMarkdow

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）という言葉を聞いたことがあるだろうか。Web系を中心としたプログラマならよく馴染んでいる言葉だ。 マークダウンはテキストファイルの書き方のひとつだ。特別なファイル形式ではない。見出しや強調したい部分、リンクや画像の挿入について一定のルールで書く。それ以外は、普通のテキストファイルと変わらない。 そうして書いたテキストの文書を、特定のWebサイトに投稿すると、見栄えよくHTMLに変換してくれる。手元でHTMLファイルに変換したければ、マークダウンエディタと呼ばれる種類のテキストエディタを使えばよい。エディタの一機能として、マークダウン変換機能が付いていることもある。 文書の整形に「Word」を立ち上げる必要はない。「Word」の不可思議な挙動に悩まされることもない。使い慣れたテキストエディタで、サクッと書けばよい。シンプルなテキストで、小さなファイルサイズ

はじめに Markdown でちょっとしたメモを書いていると、メモ書きのつもりが、それなりの規模になってきて、目次を作りたくなる。目次をつけるのは Markdown Preview Enhanced の機能でできる。 そんで、目次をつけると、どうも章番号を振りたくなってくる。 章番号を振る一番単純なやり方は、見出しに対して手でぽちぽち番号を振っていく方法だけれども、文章の更新がかかるたびに番号を振りなおすのはいかにも効率が悪い。 というわけで Markdown Preview Enhanced のスタイルを使って、見出しに対して自動的に章番号を割り付けるようにしたので、その方法をまとめておく( Markdown Preview Enhanced とは書いているけど、同様に CSS で見た目をコントロールしているよう他のプレビュー機能でも有効な方法のはず)。 ついでに、同様の方法で目次にも番