Show original
Try the app
Yomu
Enjoyed this article?
Support oka-project
Share
I created a Markdown editor called "Yomu" for refining and organizing text created by AI.
AI translation
AIで作った原稿を、そのまま終わらせず公開までつなげるために
About 18 min read13
AI translation
AIで作った原稿を、そのまま終わらせず公開までつなげるために
Try the app
Yomu
Enjoyed this article?
Support oka-project
Since I started using ChatGPT and Claude to write articles, the workflow for creating article drafts has changed considerably. Tasks like planning structure, creating draft text, and organizing headings and bullet points—which I used to do one step at a time—can now be done together with AI.
I've also found myself using AI more often when creating blog and website articles. Particularly, I've started having AI create manuscripts in Markdown format, and I feel that the process of thinking through text and shaping it has become much easier than before.
On the other hand, when I actually try to publish that manuscript, there's still separate work remaining.
If I'm posting to WordPress, I need to check headings, lists, tables, and so on, then adjust the manuscript to a state that's easy for WordPress to handle. With Hatena Blog, I can sometimes use Markdown mode, but when I want to add to articles I've written in Hatena notation, I need to convert the manuscript to a different format.
If I want to use the same text in Word or PDF as well, another conversion task appears.
While the process of creating text has changed considerably due to AI, the process of actually taking that text to where it will be published still had manual work remaining.
I started creating 
the Markdown editor "Yomu" to organize this part on my own.
If I just want to change a manuscript created in Markdown to a different format, I can ask ChatGPT or Claude directly.
For example, if I want to use it on Hatena Blog, I can ask "Please convert this Markdown to Hatena notation," and I can also have it formatted for WordPress. For short texts, this method is often sufficient.
I did the same at first.
However, as I started dealing with longer articles, I became concerned about the step of checking the converted manuscript. Are the heading levels the same as the original? Haven't the links changed? Is nothing missing from the table contents? Have the code and symbols remained as they were? Even though I just want the format changed, I also want to check that the body text itself hasn't changed slightly.
Because generative AI can handle text itself, it has this kind of flexibility. On the other hand, I started thinking that for the task of "keeping the content the same but changing only the format," I don't need to rely on generative AI every time.
I felt it would be easier for me to treat thinking about text and converting to a fixed format as separate processes.
From there, the way of thinking that led to today's Yomu emerged.
In my mind, I have AI think about the structure and body of the text, and handle the work up to creating the manuscript as Markdown. Then, from that point on, I leave the format conversion for each publication destination to a different tool.
ChatGPT / Claude
↓
Markdown原稿
↓
Yomu
↓
WordPress / はてなブログ / note
↓
Word / PDF / HTMLConvert from Markdown to a format suitable for WordPress. Convert to Hatena notation only when necessary. If I want to use it as Word or PDF, I output it in that format.
By dividing roles this way, I no longer need to give AI detailed instructions every time the publication destination changes. I keep the original manuscript as Markdown and only change the final part according to the intended use.
This form felt most right to me in how I handle articles.
## Why I placed Markdown in the middle
I chose Markdown because it's not a format specific to any particular service, and it allows the text to be read as-is by humans while preserving the structure of the text.
For example,
## Yomuを作った理由
AIで記事を作る機会が増えました。
- WordPressへの入稿
- はてな記法への変換
- WordやPDFへの出力With a manuscript like this, it can be read as normal text while also making the structure like headings and bullet points clear.
Rather than keeping the original manuscript in a WordPress-specific format or only in Hatena notation, if I keep one version in Markdown, it becomes easier to expand to other uses later.
In Yomu, Markdown is treated as the common manuscript before publication, and it's converted to match where it's needed only when necessary.
Of course, I don't think everything should be in Markdown. If a text is only going to be used in Word, it might be more natural to create it in Word from the start, and if I'm just pasting a short text into note once, it might be faster to just copy it as-is.
Yomu is useful in situations where a manuscript created in Markdown is then used in multiple places.
Yomu wasn't made because there were no Markdown editors in the world.
There are already many editors for writing Markdown, viewers for checking files, and services for converting formats. I've used several of these tools myself.
However, when I actually continued using them, each had small aspects that didn't quite match my usage.
Ads were prominent and made it hard to concentrate on work, the screen layout was difficult for me to use, I just wanted to check Markdown but there were too many operations, or conversely, while it was easy to use up to the point of writing Markdown, the part of taking that manuscript to WordPress or Hatena Blog was slightly different from my needs.
What I wanted wasn't the Markdown editor with the most features.
Something where I could open my usual Markdown manuscript, check it, and take it directly to where I want to use it.
Rather than wanting to create something completely different from existing services, I wanted to create something I would actually want to use myself.
In Yomu, you can write Markdown, .md open files, and check content while viewing a preview.
In the editing screen, you can work while viewing the Markdown manuscript, preview, and table of contents. However, in my mind, I prioritize where the manuscript can go after it's completed over the editing features themselves.
Currently, I'm assuming use with WordPress, Hatena Blog, note, Zenn, Qiita, Word, PDF, HTML, and others.
Not just a place for writing Markdown, but a place for taking Markdown to the next place.
This is something I've valued from the start in creating the Yomu tool.
---
What was particularly significant for me was posting to WordPress.
Even if I create a Markdown manuscript with AI, that alone doesn't complete the WordPress article update. I move the manuscript to WordPress and check headings and lists, then organize them as blocks as needed.
Of course, there are also parts like images, CTAs, and site-specific styling that are better adjusted on WordPress at the end. I'm not trying to automate all WordPress update work with Yomu.
What I wanted to shorten was the step before that: "the process of taking a Markdown manuscript to a state that's easy to handle in WordPress."
So in Yomu, I've made it possible to convert from Markdown to a format suitable for WordPress's standard blocks. The positioning is to finish in WordPress while reducing simple conversions and formatting before that point.
The oka-project side has also organized details about how to use it with WordPress.
ChatGPTのMarkdownをWordPressに貼ると崩れる？ Gutenbergブロックへ変換する方法
Hatena Blog has a Markdown mode, so if you write new articles in Markdown mode, you can use Markdown as-is.
The problem I had was when I wanted to add content created in Markdown to articles I'd written in Hatena notation.
When trying to match the format of existing articles, I needed to convert Markdown to Hatena notation. I could ask AI to convert it each time, but as I mentioned earlier, the step of comparing the conversion result with the original manuscript also occurs.
So I thought, why not make it possible to convert with Yomu only when needed?
Yomu doesn't aim to "process everything through Yomu." If Markdown can be used as-is, use it as-is. Use Yomu only when conversion is necessary. That level of positioning works for me.
The distinction in how to use it with Hatena Blog is organized here.
ChatGPTのMarkdownをはてなブログに貼る方法｜Markdownモードとはてな記法の使い分け
I also use AI in the development of Yomu itself.
In situations like researching implementation methods, organizing design, and building code, using AI has significantly expanded what an individual can handle. Particularly in the part of "taking an idea to something that actually works," I can try more things than before.
On the other hand, just because I can use AI doesn't mean I need to leave all processing to AI.
AI is strong at tasks where there isn't one right answer, like thinking about text structure and expression. On the other hand, for processes like converting from Markdown to another notation where the rules are fairly fixed, it's often easier to handle with regular programming.
In Yomu, I separate where AI is suited and where it's better to implement as fixed processing.
The goal isn't to use AI itself, but to choose the method suited to the task. For now, this approach works for me.
In Yomu, editing and converting input Markdown text is done within the browser.
I haven't set it up to send and save the input text to oka-project's server for conversion processing. Since this is a tool that often handles articles and drafts before publication, if there's no need to send to a server, I thought that would be easier for me to use.
However, this doesn't mean "everything oka-project makes is browser-only."
If I create a service in the future that requires accounts or cloud storage, I'll choose a structure suited to that. With Yomu, the browser-based processing approach simply fit the current use case.
---
Yomu wasn't started with the intention of creating a large Markdown service from the beginning.
In my daily work, while I've started creating manuscripts more with AI, I'm still moving my hands for conversion and posting afterward. At that time, I felt "if there were just a slightly more convenient tool here."
I first made it for my own use, and while actually using it, I fixed things that bothered me. Since it took shape, I decided to make it public so people doing similar work could use it too.
Yomu also came from that flow.
At oka-project, I don't intend to limit myself to just small web tools in the future, but I want to keep valuing this aspect of starting from actual problems.
Even if I haven't found issues in my own usage, I think there are cases I haven't noticed with different manuscripts or different ways of using it.
For example, there was Markdown where the conversion result was different from expected, there was still a lot of manual work remaining after taking it to WordPress, there were expressions that couldn't be properly reproduced in Hatena notation, or there are other publication destinations you'd like supported.
This includes things that were unclear when operating, or "it would be easier to use if this were like this."
You can send improvement requests and bug reports through the oka-project contact form.
While I can't add every request as-is, I want to use actual usage scenarios to understand where challenges remain, which will help me think about future improvements.
The basic usage is to open or paste Markdown, check the content in the preview, and output to the format you need.
Yomu is currently available from a browser.
Currently, you can use it without registration or installation.
If you create Markdown manuscripts with ChatGPT or Claude and then have manual work remaining in the process of taking them to WordPress or Hatena Blog, I'd appreciate it if you'd try it once.
Also, regarding the way of thinking about using Markdown as a common manuscript in multiple places, oka-project has organized this in detail.
ChatGPT・Claudeの文章をnote・WordPress・Wordへ使い回す方法｜Markdownを原本にする
I plan to continue improving Yomu gradually while using it myself.
ChatGPTやClaudeを使って文章を書くようになってから、記事の下書きを作るまでの流れはかなり変わりました。構成を考えたり、文章のたたき台を作ったり、見出しや箇条書きを整理したりと、以前なら一つずつ進めていた工程をAIと一緒に進められるようになっています。
自分自身も、ブログやWebサイトの記事を作るときにAIを使う機会が増えました。特にMarkdownで原稿を作ってもらうことが多くなり、文章を考えて形にするところまでは、以前よりかなり進めやすくなったと感じています。
一方で、実際にその原稿を公開しようとすると、別の作業が残っていました。
WordPressへ入稿するなら、見出しやリスト、表などを確認しながら、WordPress側で扱いやすい状態に整える必要があります。はてなブログではMarkdownモードを使える場合もありますが、これまで書いてきたはてな記法の記事へ追記したい場合には、原稿を別の形式へ合わせる必要があります。
同じ文章をWordやPDFでも使おうとすると、また別の形へ整える作業が発生します。
文章を作る工程はAIによってかなり変わった一方で、その文章を実際の公開先へ持っていく工程には、まだ手作業が残っていました。
この部分を自分なりに整理したくて作り始めたのが、Markdownエディタ 「Yomu」 です。
Markdownで作った原稿を別の形式へ変えたいだけなら、ChatGPTやClaudeへそのまま頼むこともできます。
たとえば、はてなブログで使いたければ「このMarkdownをはてな記法に変換してください」と頼めますし、WordPress向けの形式に整えてもらうこともできます。短い文章であれば、この方法で十分なこともあります。
自分も最初はそうしていました。
ただ、ある程度長い記事を扱うようになると、変換後の原稿を確認する工程が気になるようになりました。見出しの階層は元のままか、リンク先は変わっていないか、表の中身は抜けていないか、コードや記号はそのまま残っているか。形式を変えてほしいだけなのに、本文そのものまで少し変わっていないかも確認したくなります。
生成AIは文章そのものを扱えるからこそ、こうした柔軟さがあります。一方で、「内容はそのままで、形式だけ変えたい」という作業については、毎回生成AIへ任せる必要はないのではないかと思うようになりました。
文章を考えることと、決まった形式へ変換することは、別の工程として扱った方が自分には使いやすそうでした。
そこから、今のYomuにつながる考え方ができました。
自分の中では、AIには文章の構成や本文を考えてもらい、Markdownとして原稿を作るところまでを担当してもらう。そして、そこから先の公開先ごとの形式変換は別のツールに任せる、という流れです。
ChatGPT / Claude
↓
Markdown原稿
↓
Yomu
↓
WordPress / はてなブログ / note
↓
Word / PDF / HTMLMarkdownからWordPress向けの形式へ変える。必要な場合だけ、はてな記法へ変換する。WordやPDFとして使いたければ、その形式で書き出す。
このように役割を分けることで、公開先が変わるたびにAIへ細かい指示を出す必要がなくなります。元になる原稿はMarkdownとして残しておき、最後の部分だけ用途に合わせて変えるという考え方です。
自分が記事を扱う中では、この形が一番しっくりきました。
## なぜMarkdownを途中に置いたのか
Markdownを選んだ理由は、特定のサービス専用の形式ではなく、人がそのまま読める状態で文章の構造も残せるからです。
たとえば、
## Yomuを作った理由
AIで記事を作る機会が増えました。
- WordPressへの入稿
- はてな記法への変換
- WordやPDFへの出力このような原稿であれば、普通の文章として読める一方で、見出しや箇条書きといった構造も分かります。
最初からWordPress専用の形式や、はてな記法だけで原稿を持つより、Markdownの状態を一つ残しておけば、あとから別の用途にも展開しやすくなります。
Yomuでは、Markdownを公開前の共通原稿として扱い、必要なときだけ使う場所に合わせて変換する形にしています。
もちろん、何でもMarkdownにすればよいとは考えていません。最終的にWordだけで使う文章なら最初からWordで作る方が自然な場合もありますし、短い文章をnoteへ一度貼るだけなら、そのままコピーした方が早いこともあります。
Yomuが役立つのは、Markdownで作った原稿を、その後も複数の場所で使う場面です。
Yomuは、Markdownエディタが世の中になかったから作ったものではありません。
Markdownを書くためのエディタも、ファイルを確認するためのViewerも、形式を変換するサービスも既にたくさんあります。自分自身も、そうしたツールをいくつか使ってきました。
ただ、実際に使い続けていると、それぞれ少しずつ自分の使い方とは合わないところがありました。
広告が目立って作業に集中しづらかったり、画面構成が自分には使いにくかったり、Markdownを確認したいだけなのに操作が多かったり。反対に、Markdownを書くところまでは使いやすくても、その原稿をWordPressやはてなブログへ持っていく部分は、自分の用途とは少し違うこともありました。
自分が欲しかったのは、Markdownエディタとして機能数が最も多いものではありません。
普段使うMarkdown原稿を開いて、確認して、そのまま使いたい場所へ持っていけるもの。
既存のものと全く違うサービスを作りたいというよりも、自分ならこちらを使いたいと思える形にしたかった、というのが一番近いです。
Yomuでは、Markdownを書いたり、.mdファイルを開いたり、プレビューを見ながら内容を確認したりできます。
編集画面では、Markdown原稿とプレビュー、目次を見ながら作業できるようにしています。ただ、自分の中では、編集機能そのものよりも原稿が完成した後にどこへ持っていけるかを重視しています。
現在は、WordPress、はてなブログ、note、Zenn、Qiita、Word、PDF、HTMLなどで使うことを想定しています。
Markdownを書くためだけの場所ではなく、Markdownを次の場所へ持っていくための場所にしたい。
Yomuというツールを作るうえで、ここは最初から大事にしている部分です。
---
自分の中で特に大きかったのが、WordPressへの入稿です。
AIでMarkdown原稿を作っても、それだけでWordPressの記事更新が完了するわけではありません。原稿をWordPressへ移し、見出しやリストを確認しながら、必要に応じてブロックとして整えていきます。
もちろん、画像やCTA、サイト固有の装飾など、WordPress上で最後に調整した方がよい部分もあります。YomuでWordPressの更新作業をすべて自動化しようとしているわけではありません。
自分が短くしたかったのは、その一つ前にある**「Markdown原稿をWordPressで扱いやすい状態へ持っていく工程」**です。
そこでYomuでは、MarkdownからWordPressの標準ブロック向けの形式へ変換できるようにしています。仕上げはWordPressで行いながら、その手前の単純な変換や整形を減らす、という位置づけです。
WordPressでの使い方については、oka-project側でも詳しく整理しています。
ChatGPTのMarkdownをWordPressに貼ると崩れる？ Gutenbergブロックへ変換する方法
はてなブログにはMarkdownモードがあるため、新しい記事をMarkdownモードで書くのであれば、そのままMarkdownを使えます。
自分の場合に困ることがあったのは、これまで書いてきたはてな記法の記事へ、Markdownで作った内容を追加したいときでした。
既存の記事の形式に合わせようとすると、Markdownをはてな記法へ変換する必要があります。毎回AIへ変換を頼むこともできますが、先ほど書いたように、変換結果を元の原稿と見比べる工程も発生します。
それなら、必要なときだけYomuで変換できるようにしよう、と考えて追加しました。
Yomuでは「何でもYomuを通す」ことを目指していません。Markdownをそのまま使えるなら、そのまま使う。変換が必要な場面だけYomuを使う。そのくらいの位置づけが、自分には合っています。
はてなブログでの使い分けについては、こちらにまとめています。
ChatGPTのMarkdownをはてなブログに貼る方法｜Markdownモードとはてな記法の使い分け
Yomuの開発そのものにもAIを活用しています。
実装方法を調べたり、設計を整理したり、コードを組み立てたりする場面では、AIを使うことで個人でも扱える範囲がかなり広がったと感じています。特に「アイデアを実際に動くものへ持っていく」という部分では、以前より試せることが増えました。
一方で、AIを使えるからといって、すべての処理をAIに任せる必要はないとも考えています。
文章の構成や表現を考えるような、答えが一つではない作業ではAIが強い。一方、Markdownから別の記法へ変換するような、ある程度ルールが決まっている処理では、通常のプログラムで処理した方が扱いやすいことがあります。
Yomuでは、AIが向いているところと、決まった処理として実装した方がよいところを分けています。
AIを使うこと自体を目的にするのではなく、その作業に合った方法を選ぶ。今のところ、自分にはこの使い方が合っています。
Yomuでは、入力したMarkdown本文の編集や変換をブラウザ内で行っています。
変換処理のために、入力した本文をoka-projectのサーバーへ送信・保存する仕組みにはしていません。公開前の記事や下書きを扱うことが多いツールなので、サーバーへ送る必要がないのであれば、その方が自分自身も使いやすいと考えたためです。
ただし、これは「oka-projectで作るものはすべてブラウザ完結にする」という方針ではありません。
今後、アカウントやクラウド保存が必要なサービスを作るのであれば、それに合った構成を選ぶと思います。Yomuでは、現在の用途に対してブラウザ内で処理する形が合っていた、というだけです。
---
Yomuは、最初から大きなMarkdownサービスを作ろうとして始めたものではありません。
普段の作業の中で、AIを使って原稿を作ることは増えたのに、その後の変換や入稿ではまだ手を動かしている。そのときに、「ここにもう少し自分が使いやすい道具があれば」と感じたことが出発点です。
まずは自分が使うために作り、実際に使いながら気になったところを直していく。せっかく形になったのであれば、同じような作業をしている人にも使えるように公開する。
Yomuも、その流れから生まれています。
oka-projectでは、今後も小さなWebツールだけに限定するつもりはありませんが、こうした実際の困りごとから作り始めるという部分は大切にしたいと思っています。
自分の使い方では確認していても、別の原稿や別の使い方では、自分では気づいていないケースがあると思います。
たとえば、変換結果が期待と違ったMarkdownがあった、WordPressへ持っていったあとにまだ手作業が多く残った、はてな記法でうまく再現できない表現があった、ほかにも対応してほしい公開先がある、といったものです。
操作していて分かりにくかったところや、「ここがこうなると使いやすい」といった内容も含めて、改善要望や不具合はoka-projectのお問い合わせフォームから送っていただけます。
すべての要望をそのまま追加できるとは限りませんが、実際の利用場面でどこに課題が残っているのかは、今後の改善を考えるうえで参考にしたいと思っています。
基本的な使い方は、Markdownを開く、または貼り付けて、プレビューで内容を確認し、必要な形式へ書き出すという流れです。
Yomuは現在、ブラウザから利用できます。
現在は登録やインストールをしなくても利用できます。
ChatGPTやClaudeでMarkdown原稿を作ることがあり、その後WordPressやはてなブログなどへ持っていく工程に手作業が残っている方には、一度試してもらえればと思っています。
また、Markdownを共通の原稿として複数の場所で使う考え方については、oka-projectでも詳しくまとめています。
ChatGPT・Claudeの文章をnote・WordPress・Wordへ使い回す方法｜Markdownを原本にする
Yomuは、自分自身でも使いながら、これからも少しずつ改善していく予定です。