常連

## テーマ、知りたいこと

Markdownってよく聞くのですが、具体的にどんなメリットがあるのでしょうか？
他の記法と比べて何が優れているのか、初心者に分かりやすく教えてほしいです。

## 背景、状況

最近、ブログを始めようと思っています。色々な記事を読んでいると、Markdown記法で書くのが良いと書かれていましたが、HTMLなど他の記法と比べて何がどう良いのかイマイチ理解できていません。HTMLで書くのと比べて、具体的にどんなメリットがあるのでしょうか？
また、学習コストも気になっています。簡単に習得できるのでしょうか？

Markdownとはなんですか？

## テーマ、知りたいこと

皆さんはどのような形式でファイルの管理やディレクトリの管理をしデータを管理しているのでしょうか？
自分は最近、PCのディレクトリを整理したり個人のスマホのメモ帳でメモっていた内容すべてをスプレッドシートに移行したりしていました。
特にディレクトリについては、決まったテンプレートもなく開発で様々なソフトを使っているとuser(ログイン名)のディレクトリにたくさん不要なファイルが作られたりして行きますよね。
そこでmyFolder的なのを作って
project,社内情報, 報告書、toolなどのフォルダを作っています。

メモについてはプログラミングに関して言えば
対象, 概要, メモ
のような列を持ったスプレッドシート状のテーブルを作成して、対象には言語やソフトウェアが何かを書いて管理しています。

また、こういった情報って業務上で学べるものなんでしょうか？新卒で採用された経験がないので新人研修的なものもなく、どのように皆さん考えておられるのか不思議です。

## 背景、状況

twitterで
「今新入社員にひと言伝えるなら、「すべての情報を基本mdファイルで管理しよう」ですね」
という内容の投稿が2,000回以上いいねされていました。

また、友人から「エンジニアだったりパソコンに詳しい人はオフィスソフトじゃなくてmdを使うのか？」と質問され、自分の考えが特殊なのもあり皆さんのご意見をお伺いしたいと思いました。

mdって使いづらい感じがするんですが、そんなにいいものでしょうか。
段落を自分で考えねばならず、ファイル毎の管理になるのでデータ管理としては見通しもよくありません。
人に見せる用の使い捨てであればわかりますが、すべての情報をと記載されていますしmdってデータの管理の側面で使い道あるのでしょうか。
md以外の形式からmdとしてデータを出力するプログラムはかけそうですが、逆は厳しい感じもします。

## 補足
mdだけに話題を絞ると内容がなさそうなので、データ管理全般についてもお伺いしようかと思いました。
意見交換の使い方がいまいち分かっていないのですが。
使い方がどこに書いているのか定かではありませんでしたが、とりあえず以下の内容を読むに問題無さそうと判断しています。
https://blog.teratail.com/entry/release-discussion

## 質問後追記
投稿前に気づけよって話ですがgitでバージョン管理しているなら、mdとクラウドサービス一択になりそうですね。。。
自分のところではsvnを使用しているので、完全に失念していました。。。
そう考えると使い分けの考えについても完全に納得いきます。。。

データの管理、ディレクトリやファイル形式について

### 実現したいこと
mdファイルの中にある「サンプル文字」をwordに書き込みたいが、**下線を引いた状態で出力できない。**

プログラムは実行できる、wordファイルも出力できる。wordに文字も出力されている。

### 発生している問題・分からないこと
luaフィルタのRawInline関数で下線が見つかったならば、pandocを用いて下線を引く処理を追記しているが出力されたwordファイルを見ると、下線が引かれていない。



### 該当のソースコード

```python(main.py)
# ■■ Pandocインストール必要(https://github.com/jgm/pandoc/releases/tag/3.6.4)
import os, re
import subprocess
from docx import Document
import time

# Markdownの整形処理
def md_edit(md_file_path, temp_file_path):
 with open(md_file_path, 'r', encoding='utf-8') as infile, open(temp_file_path, 'w', encoding='utf-8') as outfile:
 prev_line_flg = False
 for line in infile:
 # リンク内のスペース除外
 if '<a name="' in line and '</a>' in line:
 start_index = line.find('<a name="') + len('<a name="')
 end_index = line.find('">', start_index)
 name_content = line[start_index:end_index].replace(' ', '').replace('　', '')
 line = line[:start_index] + name_content + line[end_index:]
 
 # URL以外は、リンク内のスペース除外
 if '](' in line and ')' in line and 'http' not in line:
 start_index = line.find('](') + len('](')
 end_index = line.find(')', start_index)
 link_content = line[start_index:end_index].replace(' ', '').replace('　', '')
 line = line[:start_index] + link_content + line[end_index:]
 
 # 行の先頭が<で次に英語または/以外の文字が続く場合、<を＜に置換し、同じ行の次の>を＞に置換
 if re.match(r'^<[^a-zA-Z/]', line):
 line = line.replace('<', '＜', 1)
 line = line.replace('>', '＞', 1)
 
 # "#"から始まる対象は、前回が空でなければ改行を追加
 if line.startswith('#') and prev_line_flg:
 outfile.write('\n') # 改行追加
 
 # ">"のみの対象は、半角スペースを追加
 if line.strip() == '>':
 line = '> \n'
 
 # 行の末尾が" "または" "の場合、除外
 if line.rstrip().endswith(' ') and line.strip() != ' ':
 line = line.rstrip()[:-4] + '\n'
 elif line.rstrip().endswith(' ') and line.strip() != ' ':
 line = line.rstrip()[:-5] + '\n'

 

 outfile.write(line) # 行反映

 # 改行のみであったかチェック
 if line == '\n':
 prev_line_flg = False
 else:
 prev_line_flg = True

# Word編集処理
def word_edit(docx_file_path):
 document = Document(docx_file_path)
 for paragraph in document.paragraphs:
 if paragraph.text.startswith('> '):
 paragraph.style = 'Quote'
 paragraph.text = paragraph.text[2:]

 document.save(docx_file_path)

def main():
 try:
 # ◆Markdownファイルリスト
 in_dir = "in"
 md_file_lists = list(filter(lambda f: f.endswith(".md"), os.listdir(in_dir)))

 # ◆ディレクトリ直下のカスタムテンプレートファイル
 # Wordのスタイルウィンドウを出して、出力したいスタイルのテンプレートを作成
 template_file = "template.docx"

 # ◆出力ディレクトリ
 out_dir = "out"

 # ◆出力ディレクトリが存在しない場合は作成
 if not os.path.exists(out_dir):
 os.makedirs(out_dir)

 # ◆Pandocコマンド実行
 if md_file_lists:
 for i, md_file in enumerate(md_file_lists):
 input_file_path = os.path.join(in_dir, md_file) # インプットファイルパス作成
 temp_file_path = os.path.join(in_dir, 'temp_' + md_file) # 一時ファイルパス作成
 output_file_path = os.path.join(out_dir, os.path.splitext(os.path.basename(md_file))[0] + ".docx") # アウトプットファイルパス作成
 
 md_edit(input_file_path, temp_file_path) # Markdownファイル整形
 
 if template_file != "":
 # ◇テンプレート指定あり
 cmd = [
 "pandoc", temp_file_path,
 "--reference-doc", template_file,
 "--lua-filter=fix.lua",
 "--wrap=preserve",
 "-o", output_file_path
 ]
 else:
 # ◇テンプレート指定なし
 cmd = [
 "pandoc", temp_file_path,
 "--lua-filter=fix.lua",
 "--wrap=preserve",
 "-o", output_file_path
 ]
 
 result = subprocess.run(cmd, capture_output=True, text=True) # Pandoc実行
 if result.returncode != 0:
 raise Exception(f"変換異常発生: {result.stderr} >{md_file}")
 
 word_edit(output_file_path) # word編集
 
 os.remove(temp_file_path) # 一時ファイル削除
 
 if i == 0: print("【変換対象ファイル一覧】")
 print(f"{i+1}: {md_file}")

 print("-- 変換完了 --")
 
 else:
 print("-- MDファイルなし --")

 except Exception as err:
 print(err)


if __name__ == '__main__':
 main()
```

```luaフィルタ(fix.lua)
local b_cnt = 0

-- ブロック処理
function RawBlock(el)
 -- 改ページ処理
 if el.text == '<div style="page-break-before:always"></div>' then
 return pandoc.RawBlock('openxml', '<w:p><w:r><w:br w:type="page"/></w:r></w:p>')
 else
 return el

 end
end

-- インライン処理
function RawInline(el)
 -- 2025/05/07下線処理
 if el.text:match('(.-)') then
 local underlined_text = el.text:match('(.-)')
 return pandoc.RawInline('openxml', '<w:r><w:rPr><w:u w:val="single"/></w:rPr><w:t>' .. underlined_text .. '</w:t></w:r>')

 -- 改行処理
 elseif el.text == ' ' or el.text == ' ' then
 return pandoc.RawInline('openxml', '<w:br/>')

 -- ブックマーク処理
 elseif el.text:match('<a name="(.-)">') then
 local b_name = el.text:match('<a name="(.-)">')
 b_cnt = b_cnt + 1
 return pandoc.RawInline('openxml', '<w:bookmarkStart w:id="' .. b_cnt .. '" w:name="' .. b_name .. '"/><w:bookmarkEnd w:id="' .. b_cnt .. '"/>')

 else
 return el

 end
end

-- リンク処理
function Link(el)
 if el.target:match("^#") then
 b_cnt = b_cnt + 1
 local b_name = el.target:sub(2):gsub("%%20", " ")
 local content = pandoc.utils.stringify(el.content)
 return {
 pandoc.RawInline('openxml', '<w:bookmarkStart w:id="' .. b_cnt .. '" w:name="' .. b_name .. '"/>'),pandoc.RawInline('openxml', '<w:hyperlink w:anchor="' .. b_name .. '"><w:r><w:t>' .. content .. '</w:t></w:r></w:hyperlink>'),
 pandoc.RawInline('openxml', '<w:bookmarkEnd w:id="' .. b_cnt .. '"/>')
 }
 else
 return el
 end
end
```

```sample.md
 アイウエオ
サンプル文字
```

### 試したこと・調べたこと
- [ ] teratailやGoogle等で検索した
- [x] ソースコードを自分なりに変更した
- [ ] 知人に聞いた
- [x] その他

##### 上記の詳細・結果
ネットで「pandoc luaフィルター」と調べ、pandoc.Underlineメソッドも使ったが実行できなかった。
[https://pandoc.org/lua-filters.html#type-inlines](url)

chatgptを使っても、私が書いたコードと同じになり、実行結果も変わらない。

### 補足
pandoc 3.6.4
python 3.8

python、pandoc、Luaフィルタを用いてmdファイルの内容をwordに書き込みたい

### 実現したいこと
①mdファイルの中に表がある。表の中には太字(＊＊)がないものもあり、pythonで＊＊を追記して、太字にしてdocxに書き込みたい。
②luaフィルタで、fontの場合、指定したsize,colorをdocxに書き込みたい。

### 発生している問題・分からないこと
①pythonで太字(＊＊)を追記して修正できているが、それが表になっていない。原因はpandocが修正した表を認識しないからというのは理解できる。しかし、fix.luaでどのように実現方法がわからない。

②fix.luaで print(color),print(size)の結果、値は取得できている。しかし、docxファイルを見てみると、指定の色やサイズになっていない。



### 該当のソースコード

```python(main.py)
# ■■ Pandocインストール必要(https://github.com/jgm/pandoc/releases/tag/3.6.4)
import os, re
import subprocess
from docx import Document
import time

# Markdownの整形処理
def md_edit(md_file_path, temp_file_path):
 with open(md_file_path, 'r', encoding='utf-8') as infile, open(temp_file_path, 'w', encoding='utf-8') as outfile:
 prev_line_flg = False
 for line in infile:
 # リンク内のスペース除外
 if '<a name="' in line and '</a>' in line:
 start_index = line.find('<a name="') + len('<a name="')
 end_index = line.find('">', start_index)
 name_content = line[start_index:end_index].replace(' ', '').replace('　', '')
 line = line[:start_index] + name_content + line[end_index:]

 # URL以外は、リンク内のスペース除外
 if '](' in line and ')' in line and 'http' not in line:
 start_index = line.find('](') + len('](')
 end_index = line.find(')', start_index)
 link_content = line[start_index:end_index].replace(' ', '').replace('　', '')
 line = line[:start_index] + link_content + line[end_index:]

 # 行の先頭が<で次に英語または/以外の文字が続く場合、<を＜に置換し、同じ行の次の>を＞に置換
 if re.match(r'^<[^a-zA-Z/]', line):
 line = line.replace('<', '＜', 1)
 line = line.replace('>', '＞', 1)

 # "#"から始まる対象は、前回が空でなければ改行を追加
 if line.startswith('#') and prev_line_flg:
 outfile.write('\n') # 改行追加

 # ">"のみの対象は、半角スペースを追加
 if line.strip() == '>':
 line = '> \n'

 # 行の末尾が" "または" "の場合、除外
 if line.rstrip().endswith(' ') and line.strip() != ' ':
 line = line.rstrip()[:-4] + '\n'
 elif line.rstrip().endswith(' ') and line.strip() != ' ':
 line = line.rstrip()[:-5] + '\n'

 # 2025/04/29 全角スペースがあるときは、半角スペースに置換
 if '　' in line.strip():
 line = line.replace('　',' ')

 #2025/05/21 表の中の太字修正
 # if ("|" in line.strip()) and ("| --" not in line.strip()) and ("jpg" not in line.strip()):
 # parts = line.split("|")[1:-1] # '','\n'を削除(スライス)

 # new_parts = []
 # for part in parts:
 # part = part.strip()

 # if ("*" in part) and ("**" not in part):
 # part = part.replace("*","**") # *が1つ存在するときもあるので修正
 # elif "*" not in part:
 # part = f"**{part}**" # *が存在しないとき**追加
 # new_parts.append(part)
 # line = "| " + " | ".join(new_parts) + " |"

 outfile.write(line) # 行反映

 # 改行のみであったかチェック
 if line == '\n':
 prev_line_flg = False
 else:
 prev_line_flg = True

# Word編集処理
def word_edit(docx_file_path):
 document = Document(docx_file_path)
 for paragraph in document.paragraphs:
 if paragraph.text.startswith('> '):
 paragraph.style = 'Quote'
 paragraph.text = paragraph.text[2:]

 document.save(docx_file_path)

def main():
 try:
 # ◆Markdownファイルリスト
 in_dir = "in"
 md_file_lists = list(filter(lambda f: f.endswith(".md"), os.listdir(in_dir)))

 # ◆ディレクトリ直下のカスタムテンプレートファイル
 # Wordのスタイルウィンドウを出して、出力したいスタイルのテンプレートを作成
 template_file = "template.docx"

 # ◆出力ディレクトリ
 out_dir = "out"

 # ◆出力ディレクトリが存在しない場合は作成
 if not os.path.exists(out_dir):
 os.makedirs(out_dir)

 # ◆Pandocコマンド実行
 if md_file_lists:
 for i, md_file in enumerate(md_file_lists):
 input_file_path = os.path.join(in_dir, md_file) # インプットファイルパス作成
 temp_file_path = os.path.join(in_dir, 'temp_' + md_file) # 一時ファイルパス作成
 output_file_path = os.path.join(out_dir, os.path.splitext(os.path.basename(md_file))[0] + ".docx") # アウトプットファイルパス作成

 md_edit(input_file_path, temp_file_path) # Markdownファイル整形

 if template_file != "":
 # ◇テンプレート指定あり
 cmd = [
 "pandoc", temp_file_path,
 "--reference-doc", template_file,
 "--lua-filter=fix.lua",
 "--wrap=preserve",
 "-o", output_file_path
 ]
 else:
 # ◇テンプレート指定なし
 cmd = [
 "pandoc", temp_file_path,
 "--lua-filter=fix.lua",
 "--wrap=preserve",
 "-o", output_file_path
 ]

 result = subprocess.run(cmd, capture_output=True, text=True) # Pandoc実行
 if result.returncode != 0:
 raise Exception(f"変換異常発生: {result.stderr} >{md_file}")

 word_edit(output_file_path) # word編集

 os.remove(temp_file_path) # 一時ファイル削除

 if i == 0: print("【変換対象ファイル一覧】")
 print(f"{i+1}: {md_file}")

 print("-- 変換完了 --")

 else:
 print("-- MDファイルなし --")

 except Exception as err:
 print(err)


if __name__ == '__main__':
 main()
```

```luaフィルタ(fix.lua)
local b_cnt = 0

-- ブロック処理
function RawBlock(el)
 -- 改ページ処理
 if el.text == '<div style="page-break-before:always"></div>' then
 return pandoc.RawBlock('openxml', '<w:p><w:r><w:br w:type="page"/></w:r></w:p>')
 else
 return el

 end
end

-- インライン処理
function RawInline(el)
 -- 2025/05/19下線処理
 if el.text == '' then
 return pandoc.RawInline('openxml', '<w:r><w:rPr><w:u w:val="single"/><w:t>')

 -- 2025/05/19下線処理
 elseif el.text == '' then
 return pandoc.RawInline('openxml', '</w:t></w:rPr></w:r>')

 -- 改行処理
 elseif el.text == ' ' or el.text == ' ' then
 return pandoc.RawInline('openxml', '<w:br/>')

 -- ブックマーク処理
 elseif el.text:match('<a name="(.-)">') then
 local b_name = el.text:match('<a name="(.-)">')
 b_cnt = b_cnt + 1
 return pandoc.RawInline('openxml', '<w:bookmarkStart w:id="' .. b_cnt .. '" w:name="' .. b_name .. '"/><w:bookmarkEnd w:id="' .. b_cnt .. '"/>')

 -- font処理 size,colorの場合がある。（問題部分はここ）
 elseif el.text:find("<font") then
 local color = el.text:match('color[ ]*=[ ]*["\']?#?([%w]+)["\']?')
 local size = el.text:match('size[ ]*=[ ]*["\']?([%w]+)["\']?')
 local openxml = '<w:r><w:rPr>'

 if color then
 openxml = openxml .. '<w:color w:val="' .. color .. '"/>'
 end

 if size then
 -- OpenXML のフォントサイズは半ポイント単位（例: size=2 → 16pt → val="32"）
 local size_val = tonumber(size) and tostring(tonumber(size) * 8) or nil
 if size_val then
 openxml = openxml .. '<w:sz w:val="' .. size_val .. '"/>'
 end
 end

 openxml = openxml .. '<w:t>'
 return pandoc.RawInline('openxml', openxml)

 elseif el.text == '' then
 --print(el.text)
 return pandoc.RawInline('openxml', '</w:t></w:rPr></w:r>')


 else
 return el

 end
end

-- リンク処理
function Link(el)
 if el.target:match("^#") then
 b_cnt = b_cnt + 1
 local b_name = el.target:sub(2):gsub("%%20", " ")
 local content = pandoc.utils.stringify(el.content)
 return {
 pandoc.RawInline('openxml', '<w:bookmarkStart w:id="' .. b_cnt .. '" w:name="' .. b_name .. '"/>'),pandoc.RawInline('openxml', '<w:hyperlink w:anchor="' .. b_name .. '"><w:r><w:t>' .. content .. '</w:t></w:r></w:hyperlink>'),
 pandoc.RawInline('openxml', '<w:bookmarkEnd w:id="' .. b_cnt .. '"/>')
 }
 else
 return el
 end
end
```

```sample.md
| アイウエオ |　(pythonでアイウエオに**をつけて太字にしたい)
| ------------------------------------------------------------ |
| *ユーザー名：〜〜〜* *パスワード：〜〜〜* |　(pythonで*を**にしたい)
| **カキクケコ** |　(カキクケコは問題ない)
| *担当者ID：〜〜〜* * パスワード：〜〜〜* |　(pythonで*を**にしたい)
```

### 試したこと・調べたこと
- [ ] teratailやGoogle等で検索した
- [x] ソースコードを自分なりに変更した
- [ ] 知人に聞いた
- [ ] その他

##### 上記の詳細・結果
python,luaフィルタのコードのエラーはなく、docxファイルは作成される。
①上記のコードを書いたが、表になっていない。
②指定の色やサイズになっていない。

### 補足
python 3.8.10
pandoc 3.6.4
OS:Windows

python,pandoc,luaフィルタで、太字(**)＆指定font機能を実現し、docxファイルに書き込みたい

### 前提・実現したいこと

VS CodeでMarkdownを記述してローカルに保存した画像を表示したいのですが、表示できません。
VS Code自体は先程インストールしたばかりで特別な設定などはしておりません(日本語にしてpast imageという拡張機能を導入したくらいです)。
```
![](google.png)
```
フォルダ階層は以下の通りです。(Test1.mdがMarkdown記述ファイルです)
![](aeeeebcaebcd6aebbad647a6670665b0.png)


単純に画像を表示する機能がないだけだと思い、以下のように記述したところ画像の表示がされました。
```ここに言語名を入力
![](https://teratail.storage.googleapis.com/assets/img/common/icnReloadBtn.png?1536717371869247)
```
また、相対パスの設定か何かがおかしいのかと思い、以下のような記述にしてみても表示されませんでした。
```
![](file:///C:/フォルダまでのパス/google.png)
```

どなたかご教授よろしくお願い致します。

追記
以下のようになっています。
![イメージ説明](b27762345b2471f9199b5e656bee4e41.png)

VS CodeでMarkdownを記述してローカルに保存した画像の表示方法

###前提・実現したいこと
 ←ここにスペースを空けたい

###発生している問題・エラーメッセージ
 ←ここにスペースが空かない

###該当のソースコード
```text
 ←ここにスペースを空けたい
```

###試したこと
 ←ここに半角スペース
 ←ここに全角スペース
          ←ここに全角スペース*10
.          ←行頭以外はスペースが効く


###補足情報(言語/FW/ツール等のバージョンなど)

行頭に半角/全角スペースをいくら突っ込んでも、プレビュー段階で勝手に削除されてしまう。
単純に行頭を1文字下げてテキストを表示したい。

コード中の2行目以降であれば効くが(何故か1行目は効かない)、平文の部分で行いたい。
ヘルプのmarkdownには該当のような項目の記載はなかった。
HTML等は当然無効。

というか半角だけならまだしも全角を勝手に潰すってのはどうなんだ。

![イメージ説明](6599668debf1503d10a41f05165fece5.png)

【teratail】行頭にスペースを入れたい

### 前提・実現したいこと

JupyterのMarkdownでの出力において、表自体（表のセルの内容ではなく）を
左に寄せる形で出力したいです。

### 発生している問題・エラーメッセージ

表自体が中央ぞろえのような形で出力されます。
※両画面端までいくような大きな表ではなく、比較的小さな表です。

### 試したこと

Jupyter 表 Markdown
といったキーワードで検索しましたが、
実現したい方法がみつかりませんでした。

### 補足情報（FW/ツールのバージョンなど）
Windows7 32bit
Jupyter 5.0.0
Python 2.7.13
Anaconda custom (32-bit)
IPython 5.3.0
Chrome 64.0.3282.186（Official Build） （32 ビット）

JupyterのMarkdownで表自体を左寄せしたい

VS Code Markdown　で画像がPreviewに表示されません。
ここは初めてなので使い方がうまくないと思いますが、ご容赦ください（ご指摘は歓迎します）

![イメージ説明](https://ddjkaamml8q8x.cloudfront.net/questions/2022-06-30/e9aae459-b212-4ee8-98c9-58e9033c55d6.png)
ワークスペースに記述したマークダウンに画像を表示しようとするとローカルフォルダへの画像の表示ができません。
~~~
![BorderLine種類](img/BorderLine.png)
![qwerty](file:///C:/tmp/BorderLine.png)
![Test](./img/BorderLine.png)
![Test1](../../c#/img/BorderLine.png)


![picture 2](https://images.tetsudo.com/report/305/65_001.jpg)
~~~
インターネットのURLに対しては表示されていますが、このマークダウンファイルを起点とした表示などではうまくいきません。
ワークスペースを起点とかするという話もあったので、念のため　プログラムヒント.code-workspace　のあるフォルダからのパスも書きましたが(Test1)ワークスペースの起点の位置がこのファイルの位置かもわからない程度なのかもしれませんがダメでした。

拡張機能は、使ってもいない Jupytter や、Kite, Markdown All in One, Path Intellisense, PrintCode,Python, Remote WSL, vscode.pdf などなどいろいろ入れています。

Markdown Imageは、いったん入れて外して　Paste Imageを入れましたが、どうやら入れる前と後で変わりはないようです。

なお、OSは　Windows11 Proです。

どうか、よろしくお願いします。